evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -1,80 +0,0 @@
1
- import { execFile } from 'node:child_process';
2
- import { CodexAppServerClient } from './app-server-client.js';
3
- import { resolveCodexLaunchCommand } from '../baseagent.js';
4
- import { catalogHash, parseModelList } from '../../core/model/catalog-service.js';
5
- async function cliModels() {
6
- const launch = resolveCodexLaunchCommand(['debug', 'models']);
7
- if (!launch)
8
- return null;
9
- return new Promise(resolve => {
10
- execFile(launch.command, launch.args, {
11
- timeout: 3000,
12
- windowsHide: true,
13
- windowsVerbatimArguments: launch.windowsVerbatimArguments,
14
- maxBuffer: 16 * 1024 * 1024,
15
- encoding: 'utf8',
16
- }, (error, stdout) => {
17
- try {
18
- if (error)
19
- return resolve(null);
20
- const json = JSON.parse(stdout);
21
- if (!Array.isArray(json?.models))
22
- return resolve(null);
23
- resolve(parseModelList(json.models.filter((m) => m.visibility === 'list'))
24
- .map(m => ({ ...m, verification: 'unverified' })));
25
- }
26
- catch {
27
- resolve(null);
28
- }
29
- });
30
- });
31
- }
32
- /** A catalog-only client uses the same transport configuration as inference. */
33
- export async function codexNativeCatalog(context, options = {}) {
34
- if (context.baseagent !== 'codex')
35
- return null;
36
- const client = new CodexAppServerClient({
37
- apiKey: context.apiKey ?? '', authType: context.authType, baseUrl: context.baseUrl,
38
- provider: context.providerId ? `evolcore_registry_${catalogHash(context.providerId).slice(0, 20)}` : context.provider,
39
- isolatedProvider: context.providerId !== undefined,
40
- headers: context.headers, queryParams: context.queryParams,
41
- });
42
- let timer;
43
- let expired = false;
44
- try {
45
- return await Promise.race([
46
- (async () => {
47
- const models = [];
48
- const seen = new Set();
49
- let cursor;
50
- do {
51
- const page = await client.modelList(false, cursor);
52
- if (expired)
53
- throw new Error('Model catalog timeout');
54
- if (!Array.isArray(page.data))
55
- throw new Error('Invalid native model list');
56
- models.push(...parseModelList(page.data.filter(m => !m.hidden && m.enabled !== false)));
57
- cursor = page.nextCursor || undefined;
58
- if (cursor && (seen.has(cursor) || seen.size >= 100))
59
- throw new Error('Invalid native model pagination');
60
- if (cursor)
61
- seen.add(cursor);
62
- } while (cursor);
63
- return [...new Map(models.map(m => [m.id, m])).values()];
64
- })(),
65
- new Promise((_, reject) => { timer = setTimeout(() => { expired = true; reject(new Error('Model catalog timeout')); }, 5000); }),
66
- ]);
67
- }
68
- catch {
69
- if (options.allowCliFallback === false)
70
- return null;
71
- // The host CLI catalog has no guarantee of matching this Agent connection.
72
- // It is useful metadata/suggestions and always remains unverified.
73
- return await cliModels();
74
- }
75
- finally {
76
- if (timer)
77
- clearTimeout(timer);
78
- await client.close();
79
- }
80
- }
@@ -1,41 +0,0 @@
1
- /**
2
- * ecagent 插件的懒加载外壳。
3
- *
4
- * 为什么要这一层:`agents/ecagent-runner.js` 会连带加载整个 ecagent 运行时
5
- * (它依赖 typebox,模块图里仅 typebox 就有两千多次 resolve)。实测这段独占
6
- * 约 360ms,是 daemon 启动模块加载中最大的一块。而绝大多数部署根本不用 ecagent
7
- * ——本机一个声明了 `baseagents.ecagent` 的 Agent 都没有。
8
- *
9
- * 因此这里只保留插件身份和一个轻量的启用判定;真正的 Runner 在第一次需要时才
10
- * 加载。判定逻辑与 `resolveEcagentConfig` 一致(它位于 baseagent.ts,不依赖
11
- * 运行时),所以「能否启用」的结论与按需加载后完全相同。
12
- */
13
- import { resolveEcagentConfig } from './baseagent.js';
14
- /** 真正的实现模块只加载一次,失败也不重复尝试。 */
15
- let realPluginPromise = null;
16
- function loadRealPlugin() {
17
- realPluginPromise ??= import('./ecagent-runner.js').then(module => new module.EcagentAgentPlugin());
18
- return realPluginPromise;
19
- }
20
- export class EcagentAgentPluginLazy {
21
- name = 'ecagent';
22
- isEnabled(agent) {
23
- const override = agent.config.baseagents?.ecagent;
24
- if (!override)
25
- return false;
26
- try {
27
- resolveEcagentConfig({ agents: { ecagent: override } }, override);
28
- return true;
29
- }
30
- catch {
31
- return false;
32
- }
33
- }
34
- async createAgent(agent, callbacks, lifecycle) {
35
- // 调用方已经通过 isEnabled 判定过,这里再确认一次以保持与直接使用真插件时一致的行为。
36
- const plugin = await loadRealPlugin();
37
- if (!plugin.isEnabled(agent))
38
- return null;
39
- return plugin.createAgent(agent, callbacks, lifecycle);
40
- }
41
- }
@@ -1,55 +0,0 @@
1
- // Tool-call time awareness: stamp the wall clock into the conversation at every
2
- // natural tool-call pause point.
3
- //
4
- // 为什么需要:入站消息渲染层(eck/message-renderer.ts)只在消息到达时打时间戳,
5
- // 工具调用期间模型完全不知道过去了多久。连续调用十几分钟的工具时,模型无法感知
6
- // 时间推移,也就无从判断"该向 owner 报一声进度了"。
7
- //
8
- // 各 base agent 的注入通道不同,但渲染文本统一走这里,保证三个基座口径一致:
9
- // - Claude Code:PostToolBatch hook 的 additionalContext(每批一次)
10
- // - ecagent:harness 'context' hook,在下次请求前给末尾 toolResult 追加一段 text
11
- // - Codex:app-server 无 PostToolUse hook,走 turn/steer 的 additionalContext
12
- //
13
- // 批次语义(与 PostToolBatch 定义一致):模型一次请求里可能并行发出多个 tool_use,
14
- // 全部 resolve 后才是一次停顿。串行调用时每轮都会停顿一次,因此"每批一次"在串行
15
- // 场景下等价于"每次工具一次"。
16
- //
17
- // 只注入时间点、不注入耗时:模型看到相邻停顿点的时间戳即可自行推算间隔,首条用户
18
- // 消息也带时间戳,起点同样可得。省掉耗时字段后单行长度压到 20 字符以内。
19
- /**
20
- * 形如 "[⏱ 11-03 01:02:21]":本机时间,去掉年份与时区偏移,只为让模型感知"现在几点"。
21
- * timeZone 仅测试用;生产走本机时区(不传即取进程默认)。
22
- */
23
- export function renderToolTime(now = Date.now(), timeZone) {
24
- const parts = new Intl.DateTimeFormat('en-US', {
25
- ...(timeZone ? { timeZone } : {}),
26
- month: '2-digit',
27
- day: '2-digit',
28
- hour: '2-digit',
29
- minute: '2-digit',
30
- second: '2-digit',
31
- hour12: false,
32
- }).formatToParts(new Date(now));
33
- const get = (type) => parts.find(part => part.type === type)?.value ?? '';
34
- const hour = get('hour') === '24' ? '00' : get('hour'); // hour12:false may yield "24" at midnight
35
- return `[⏱ ${get('month')}-${get('day')} ${hour}:${get('minute')}:${get('second')}]`;
36
- }
37
- /**
38
- * ecagent 专用:在模型请求前给末尾的 toolResult 追加一段时间文本。
39
- *
40
- * 返回 null 表示不注入(末尾不是工具结果,即本轮还没跑过工具)。调用方据此跳过改写。
41
- * 原消息不改动——它已进会话持久化,改写会污染历史;这里返回一个浅拷贝。
42
- */
43
- export function appendToolTimeToMessages(messages, now = Date.now()) {
44
- const last = messages[messages.length - 1];
45
- if (!last || last.role !== 'toolResult')
46
- return null;
47
- // toolResult 的 content 一定是 (TextContent | ImageContent)[];这里只按结构访问,
48
- // 避免本模块反向依赖 ecagent 的运行时类型。
49
- const content = last.content;
50
- const stamped = {
51
- ...last,
52
- content: [...content, { type: 'text', text: renderToolTime(now) }],
53
- };
54
- return [...messages.slice(0, -1), stamped];
55
- }
@@ -1,41 +0,0 @@
1
- /**
2
- * 一次性文件名迁移:旧名 → 规范名。
3
- *
4
- * 背景:中心/服务两侧的配置文件改成「每个东西只有一个名字」(`events-config.json` /
5
- * `services-config.json` / 包声明统一 `pack.json`),不留别名。留别名会让 agent 多一次
6
- * 「这里该写哪个名」的判断,而这正是我们要消除的东西。
7
- *
8
- * 但存量机器上还有旧名。取舍:**只搬运、不双读**——启动时把旧名重命名成新名,
9
- * 之后所有代码只认规范名。这样既不产生"两套名字都能用"的长期负担,也不会把
10
- * 用户已配好的策略弄丢。
11
- */
12
- import fs from 'node:fs';
13
- import path from 'node:path';
14
- import { logger } from '../utils/logger.js';
15
- /**
16
- * 把 `dir/legacyName` 重命名为 `dir/canonicalName`。
17
- *
18
- * @returns 是否发生了迁移
19
- */
20
- export function migrateLegacyFileName(dir, legacyName, canonicalName, label) {
21
- const legacyPath = path.join(dir, legacyName);
22
- const canonicalPath = path.join(dir, canonicalName);
23
- if (!fs.existsSync(legacyPath))
24
- return false;
25
- // 两个都在:不猜哪个是对的,保留规范名并告警,让用户自己处理旧文件。
26
- if (fs.existsSync(canonicalPath)) {
27
- logger.warn(`[migration] ${label}: 同时存在 ${legacyName} 与 ${canonicalName},已忽略前者;` +
28
- `请删除 ${legacyPath}`);
29
- return false;
30
- }
31
- try {
32
- fs.renameSync(legacyPath, canonicalPath);
33
- logger.info(`[migration] ${label}: ${legacyName} → ${canonicalName}`);
34
- return true;
35
- }
36
- catch (error) {
37
- logger.warn(`[migration] ${label}: 无法重命名 ${legacyPath}: ` +
38
- `${error instanceof Error ? error.message : String(error)};将按缺少配置处理`);
39
- return false;
40
- }
41
- }
@@ -1,137 +0,0 @@
1
- export class PluginHandle {
2
- owner;
3
- teardown;
4
- resources = new Map();
5
- pending = new Map();
6
- intervals = new Map();
7
- timeouts = new Map();
8
- controller = new AbortController();
9
- disposal;
10
- currentState = 'active';
11
- constructor(owner, teardown) {
12
- this.owner = owner;
13
- this.teardown = teardown;
14
- }
15
- get state() { return this.currentState; }
16
- get signal() { return this.controller.signal; }
17
- get resourceCount() { return this.resources.size + this.pending.size; }
18
- assertActive() {
19
- if (this.currentState !== 'active')
20
- throw new Error(`Plugin ${this.owner} is ${this.currentState}`);
21
- }
22
- defer(disposer, label = 'resource') {
23
- this.assertActive();
24
- let disposal;
25
- const release = () => {
26
- if (disposal)
27
- return disposal;
28
- this.resources.delete(release);
29
- let resolve;
30
- let reject;
31
- disposal = new Promise((done, fail) => { resolve = done; reject = fail; });
32
- const pending = disposal;
33
- this.pending.set(pending, label);
34
- pending.then(() => this.pending.delete(pending), () => this.pending.delete(pending));
35
- try {
36
- Promise.resolve(disposer()).then(resolve, reject);
37
- }
38
- catch (error) {
39
- reject(error);
40
- }
41
- return disposal;
42
- };
43
- this.resources.set(release, label);
44
- return release;
45
- }
46
- subscribe(eventBus, eventType, handler) {
47
- return this.listen(eventBus, eventType, handler);
48
- }
49
- listen(emitter, event, listener) {
50
- this.assertActive();
51
- const ownedListener = (...args) => {
52
- if (this.currentState === 'active')
53
- listener(...args);
54
- };
55
- emitter.on(event, ownedListener);
56
- return this.defer(() => { emitter.off(event, ownedListener); }, `event:${String(event)}`);
57
- }
58
- setInterval(callback, delayMs) {
59
- this.assertActive();
60
- const timer = setInterval(() => {
61
- if (this.currentState === 'active')
62
- callback();
63
- }, delayMs);
64
- const release = this.defer(() => {
65
- globalThis.clearInterval(timer);
66
- this.intervals.delete(timer);
67
- }, 'interval');
68
- this.intervals.set(timer, release);
69
- return timer;
70
- }
71
- clearInterval(timer) {
72
- const release = this.intervals.get(timer);
73
- if (release)
74
- return Promise.resolve(release());
75
- globalThis.clearInterval(timer);
76
- return Promise.resolve();
77
- }
78
- clearTimeout(timer) {
79
- const release = this.timeouts.get(timer);
80
- if (release)
81
- return Promise.resolve(release());
82
- globalThis.clearTimeout(timer);
83
- return Promise.resolve();
84
- }
85
- setTimeout(callback, delayMs) {
86
- this.assertActive();
87
- const timer = setTimeout(() => {
88
- this.resources.delete(release);
89
- this.timeouts.delete(timer);
90
- if (this.currentState === 'active')
91
- callback();
92
- }, delayMs);
93
- const release = this.defer(() => {
94
- globalThis.clearTimeout(timer);
95
- this.timeouts.delete(timer);
96
- }, 'timeout');
97
- this.timeouts.set(timer, release);
98
- return timer;
99
- }
100
- /**
101
- * `options.teardownBudgetMs` 只给进程退出路径用,透传给 teardown(目前只有 AUN 渠道
102
- * 的 `client.close()` 关心):daemon 反正马上 `exit(0)`,等不满的网络握手没有意义。
103
- */
104
- dispose(options = {}) {
105
- if (this.disposal)
106
- return this.disposal;
107
- this.currentState = 'disposing';
108
- const resources = [...this.resources].reverse();
109
- const pending = [...this.pending];
110
- this.disposal = Promise.resolve().then(async () => {
111
- const errors = [];
112
- const cleanup = async (operation, label) => {
113
- try {
114
- await (typeof operation === 'function' ? operation() : operation);
115
- }
116
- catch (cause) {
117
- errors.push(new Error(`Plugin ${this.owner}: ${label}`, { cause }));
118
- }
119
- };
120
- await Promise.all([
121
- ...resources.map(([release, label]) => cleanup(release, label)),
122
- ...pending.map(([operation, label]) => cleanup(operation, label)),
123
- ]);
124
- try {
125
- await this.teardown?.(options.teardownBudgetMs);
126
- }
127
- catch (cause) {
128
- errors.push(new Error(`Plugin ${this.owner}: teardown`, { cause }));
129
- }
130
- this.currentState = 'disposed';
131
- if (errors.length)
132
- throw new AggregateError(errors, `Plugin ${this.owner} cleanup failed`);
133
- });
134
- this.controller.abort();
135
- return this.disposal;
136
- }
137
- }
@@ -1,53 +0,0 @@
1
- /**
2
- * 分钟/小时双窗口限流,按 key 独立计数。
3
- *
4
- * 事件侧与服务侧共用同一份算法:两侧都是「按来源 AID 限制调用频率」,
5
- * 差别只在额度来源(services-config.json 的 rateLimit vs events-config.json 的 rateLimit)。
6
- * 抽出来是为了避免两套实现各自漂移——限流行为不一致比没有限流更难排查。
7
- *
8
- * **这是固定窗口,不是滑动窗口。** 每分钟(每小时)从第一次调用起算一格,到点整体清零。
9
- * 后果是边界处最多放行到 2 倍额度:59 秒用完 60 次,60 秒满血又 60 次。
10
- * 对"保护订阅方脚本不被失控的发布方打爆"这个目的够用——它防的是持续过载,
11
- * 不是精确配额。真要严格,得换成令牌桶或滑动日志,代价是每 key 存一条时间序列。
12
- */
13
- const MINUTE_MS = 60_000;
14
- const HOUR_MS = 3_600_000;
15
- export class RateWindow {
16
- windows = new Map();
17
- /** 记一次消费;超限时不计数并给出 retryAfter。 */
18
- consume(key, quota, now = Date.now()) {
19
- let window = this.windows.get(key);
20
- if (!window) {
21
- window = { minuteStart: now, minuteCount: 0, hourStart: now, hourCount: 0 };
22
- this.windows.set(key, window);
23
- }
24
- if (now - window.minuteStart >= MINUTE_MS) {
25
- window.minuteStart = now;
26
- window.minuteCount = 0;
27
- }
28
- if (now - window.hourStart >= HOUR_MS) {
29
- window.hourStart = now;
30
- window.hourCount = 0;
31
- }
32
- if (window.minuteCount >= quota.perMinute) {
33
- return { allow: false, retryAfter: Math.max(1, Math.ceil((window.minuteStart + MINUTE_MS - now) / 1000)) };
34
- }
35
- if (window.hourCount >= quota.perHour) {
36
- return { allow: false, retryAfter: Math.max(1, Math.ceil((window.hourStart + HOUR_MS - now) / 1000)) };
37
- }
38
- window.minuteCount++;
39
- window.hourCount++;
40
- return { allow: true };
41
- }
42
- /** 定期清理空窗口,避免长期运行后按 AID 无限增长。 */
43
- prune(now = Date.now()) {
44
- for (const [key, window] of this.windows) {
45
- if (now - window.hourStart >= HOUR_MS && now - window.minuteStart >= HOUR_MS)
46
- this.windows.delete(key);
47
- }
48
- }
49
- /** 清空全部窗口(配置切换 / 关闭时)。 */
50
- reset() {
51
- this.windows.clear();
52
- }
53
- }
@@ -1,60 +0,0 @@
1
- export async function disposeAgentInstances(instances, onError) {
2
- await Promise.allSettled(instances.map(async (instance) => {
3
- try {
4
- if (instance.lifecycle)
5
- await instance.lifecycle.dispose();
6
- else
7
- await instance.agent.dispose?.();
8
- }
9
- catch (error) {
10
- onError?.(instance, error);
11
- }
12
- }));
13
- }
14
- export function createRunnerReloadTransaction(input) {
15
- const prefix = `${input.aid}::`;
16
- const previous = [...input.agentMap.entries()]
17
- .filter(([key]) => key.startsWith(prefix))
18
- .map(([key, agent]) => {
19
- const split = key.lastIndexOf('::');
20
- return {
21
- evolagentName: key.slice(0, split),
22
- baseagent: key.slice(split + 2),
23
- agent,
24
- };
25
- });
26
- let committed = false;
27
- let stagedDisposed = false;
28
- const disposeStaged = async () => {
29
- if (stagedDisposed)
30
- return;
31
- stagedDisposed = true;
32
- await disposeAgentInstances(input.staged, input.onDisposeError);
33
- };
34
- return {
35
- commit() {
36
- if (committed)
37
- return;
38
- for (const instance of previous)
39
- input.agentMap.delete(`${instance.evolagentName}::${instance.baseagent}`);
40
- for (const instance of input.staged)
41
- input.agentMap.set(`${instance.evolagentName}::${instance.baseagent}`, instance.agent);
42
- committed = true;
43
- },
44
- async rollback() {
45
- if (committed) {
46
- for (const instance of input.staged)
47
- input.agentMap.delete(`${instance.evolagentName}::${instance.baseagent}`);
48
- for (const instance of previous)
49
- input.agentMap.set(`${instance.evolagentName}::${instance.baseagent}`, instance.agent);
50
- committed = false;
51
- }
52
- await disposeStaged();
53
- },
54
- async finalize() {
55
- if (!committed)
56
- return;
57
- await disposeAgentInstances(previous, input.onDisposeError);
58
- },
59
- };
60
- }
@@ -1,90 +0,0 @@
1
- import crypto from 'node:crypto';
2
- import fs from 'node:fs';
3
- import path from 'node:path';
4
- export const RUNTIME_LOCK_DIR_ENV = 'EVOLCORE_RUNTIME_LOCK_DIR';
5
- /**
6
- * Resolve a task-provided lock location without accepting relative or escaped
7
- * paths. When no managed task context is present, callers retain their legacy
8
- * on-disk lock path for daemon-side compatibility and migration tooling.
9
- */
10
- export function resolveManagedLockPath(namespace, identity, legacyPath) {
11
- const configured = process.env[RUNTIME_LOCK_DIR_ENV]?.trim();
12
- if (!configured || !path.isAbsolute(configured) || !namespace || !identity || !isTrustedRuntimeLockDir(configured)) {
13
- return legacyPath;
14
- }
15
- const digest = crypto.createHash('sha256').update(identity).digest('hex').slice(0, 24);
16
- return path.join(path.resolve(configured), namespace, `${digest}.lock`);
17
- }
18
- function isTrustedRuntimeLockDir(candidate) {
19
- const resolved = path.resolve(candidate);
20
- const tmpRoot = process.env.TMPDIR?.trim();
21
- if (!tmpRoot || !path.isAbsolute(tmpRoot))
22
- return false;
23
- const resolvedTmpRoot = path.resolve(tmpRoot);
24
- const tmpBase = path.basename(resolvedTmpRoot);
25
- const isSessionLockDir = /^ec-session-[a-f0-9]{24}$/.test(tmpBase)
26
- && path.basename(resolved) === 'locks'
27
- && path.dirname(resolved) === resolvedTmpRoot;
28
- // The app-server process has no EvolCore session yet and retains its own
29
- // process-lifetime lock namespace. Both process and session roots use the
30
- // same `$TMPDIR/locks` layout.
31
- const isProcessLockDir = /^evolcore-managed-tmp-/.test(tmpBase)
32
- && path.basename(resolved) === 'locks'
33
- && path.dirname(resolved) === resolvedTmpRoot;
34
- if (!isSessionLockDir && !isProcessLockDir)
35
- return false;
36
- try {
37
- // Windows Stats.mode does not describe ACL privacy. The managed runtime
38
- // roots are protected by Windows ACL inheritance, so apply POSIX
39
- // ownership and permission-bit checks only where those fields are
40
- // meaningful.
41
- const isWindows = process.platform === 'win32';
42
- const tmpStat = fs.lstatSync(resolvedTmpRoot);
43
- if (!tmpStat.isDirectory() || tmpStat.isSymbolicLink())
44
- return false;
45
- if (!isWindows && typeof process.getuid === 'function' && tmpStat.uid !== process.getuid())
46
- return false;
47
- if (!isWindows && (tmpStat.mode & 0o077) !== 0)
48
- return false;
49
- const stat = fs.lstatSync(resolved);
50
- if (!stat.isDirectory() || stat.isSymbolicLink())
51
- return false;
52
- if (!isWindows && typeof process.getuid === 'function' && stat.uid !== process.getuid())
53
- return false;
54
- return isWindows || (stat.mode & 0o077) === 0;
55
- }
56
- catch {
57
- return false;
58
- }
59
- }
60
- export function ensureManagedLockParent(lockPath) {
61
- const configured = process.env[RUNTIME_LOCK_DIR_ENV]?.trim();
62
- if (!configured || !isTrustedRuntimeLockDir(configured)) {
63
- throw new Error('managed runtime lock directory is not trusted');
64
- }
65
- const root = path.resolve(configured);
66
- const parent = path.resolve(path.dirname(lockPath));
67
- const relative = path.relative(root, parent);
68
- if (relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
69
- throw new Error('managed runtime lock parent escapes its runtime directory');
70
- }
71
- // Create each component individually. mkdir({recursive:true}) would follow a
72
- // pre-existing symlink in a namespace component before it can be checked.
73
- let current = root;
74
- for (const segment of relative.split(path.sep).filter(Boolean)) {
75
- current = path.join(current, segment);
76
- try {
77
- fs.mkdirSync(current, { mode: 0o700 });
78
- }
79
- catch (error) {
80
- if (error?.code !== 'EEXIST')
81
- throw error;
82
- }
83
- const stat = fs.lstatSync(current);
84
- if (!stat.isDirectory() || stat.isSymbolicLink()
85
- || (process.platform !== 'win32' && typeof process.getuid === 'function' && stat.uid !== process.getuid())
86
- || (process.platform !== 'win32' && (stat.mode & 0o077) !== 0)) {
87
- throw new Error(`managed runtime lock path is not a private real directory: ${current}`);
88
- }
89
- }
90
- }
package/dist/core/soul.js DELETED
@@ -1,66 +0,0 @@
1
- import fs from 'fs';
2
- import path from 'path';
3
- import { agentSoulDir, kitsTemplatesDir, SOUL_GUIDE_FILE } from '../paths.js';
4
- import { fileCache } from './daemon-file-cache.js';
5
- /** 分册骨架的模板目录(与运行时目录同名同文件名)。 */
6
- const SOUL_TEMPLATE_DIR = 'soul';
7
- /**
8
- * 判断一个分册是否「还没被写过」。
9
- *
10
- * 新建 agent 时每个分册都会带一份占位说明(写什么、谁写、不写什么),
11
- * 方便 agent 直接看到自己该往哪写。但占位说明不是设定,不能算作已写入:
12
- * - 去掉 HTML 注释后为空 → 未写入;
13
- * - 与 `kits/templates/soul/<同名文件>` 完全一致 → 仍是未改动的骨架;
14
- * - 每条非标题行都是 `>` 引用说明 → 只写了占位提示。
15
- */
16
- export function isSoulPlaceholder(name, body) {
17
- const meaningful = body
18
- .replace(/<!--[\s\S]*?-->/g, '')
19
- .split('\n')
20
- .map(line => line.trim())
21
- .filter(line => line !== '' && !line.startsWith('#') && !line.startsWith('>'));
22
- if (meaningful.length === 0)
23
- return true;
24
- try {
25
- // 模板是随包发布的只读文件,走 kits 组缓存(reload 后才刷新)。
26
- const template = fileCache.getText(path.join(kitsTemplatesDir(), SOUL_TEMPLATE_DIR, name), { policy: 'on-reload', group: 'kits' });
27
- return template !== null && body.trim() === template.trim();
28
- }
29
- catch {
30
- return false;
31
- }
32
- }
33
- /**
34
- * 读取 soul 目录内容。
35
- *
36
- * - 跳过机制指南 `00-GUIDE.md`:它是写文件的说明,不是自我定义。
37
- * - 跳过未写入的分册(见 `isSoulPlaceholder`)。
38
- * - 目录不存在返回空结果。
39
- */
40
- export function readSoulFiles(aid, group = `agent-files:${aid}`) {
41
- const soulDir = agentSoulDir(aid);
42
- let names;
43
- try {
44
- names = fs.readdirSync(soulDir).filter(name => name.toLowerCase().endsWith('.md')).sort();
45
- }
46
- catch {
47
- return { names: [], content: null };
48
- }
49
- const parts = [];
50
- for (const name of names) {
51
- if (name === SOUL_GUIDE_FILE)
52
- continue;
53
- const raw = fileCache.getText(path.join(soulDir, name), { policy: 'mtime', group });
54
- if (raw === null)
55
- continue;
56
- const body = raw.replace(/<!--[\s\S]*?-->/g, '').trim();
57
- if (!body || isSoulPlaceholder(name, raw))
58
- continue;
59
- parts.push(body);
60
- }
61
- return { names, content: parts.length > 0 ? parts.join('\n\n') : null };
62
- }
63
- /** 只要能拼进 prompt / 喂给判定模型的正文。 */
64
- export function readSoulContent(aid) {
65
- return readSoulFiles(aid).content;
66
- }
@@ -1,40 +0,0 @@
1
- /**
2
- * system-session/grants.ts — 写入目标与模块声明的可写文件逐个精确比对
3
- *
4
- * 输入只有 canonicalToolCall 给出的写入目标和 grants().writeFiles,不读任何 runner 的工具入参。
5
- */
6
- import fs from 'fs';
7
- import { isSameOrDescendant, resolveProtectedCandidateWithoutFinalSymlink, } from '../permission/protected-paths.js';
8
- /**
9
- * 每个写入目标都必须正好是某个声明的可写文件:
10
- * - 祖先目录按 realpath 解析、最后一段按字面比较(目标若是符号链接,比较的是链接本身,不跟随);
11
- * - 目标已存在时必须是普通文件且只有一个硬链接,链接、目录、硬链接一律拒绝;
12
- * - 相对路径按会话 cwd 解析。目标列表为空表示取不到路径,按拒绝处理。
13
- */
14
- export function checkWriteTargets(targets, writeFiles, cwd) {
15
- if (targets.length === 0)
16
- return { ok: false, reason: 'no-target' };
17
- const allowed = writeFiles.map(file => resolveProtectedCandidateWithoutFinalSymlink(file));
18
- for (const target of targets) {
19
- const resolved = resolveProtectedCandidateWithoutFinalSymlink(target, cwd);
20
- if (!allowed.some(file => samePath(resolved, file))) {
21
- return { ok: false, reason: 'outside-grant', path: resolved };
22
- }
23
- let stat;
24
- try {
25
- stat = fs.lstatSync(resolved);
26
- }
27
- catch (error) {
28
- // 尚未创建是正常情况;其余错误(权限、父路径是文件等)一律按拒绝处理。
29
- if (error.code === 'ENOENT')
30
- continue;
31
- return { ok: false, reason: 'not-regular-file', path: resolved };
32
- }
33
- if (!stat.isFile() || stat.nlink > 1)
34
- return { ok: false, reason: 'not-regular-file', path: resolved };
35
- }
36
- return { ok: true };
37
- }
38
- function samePath(a, b) {
39
- return isSameOrDescendant(a, b) && isSameOrDescendant(b, a);
40
- }