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
@@ -15,7 +15,7 @@ const SERVICE_WILDCARD = /^services(\.[A-Za-z0-9_-]+){0,2}\.\*$/;
15
15
  * service replies keep their normal durable delivery semantics. */
16
16
  export function isProjectionServiceResult(type) {
17
17
  return typeof type === 'string'
18
- && /^services\.(?:outputs\.(?:(?:snapshot|list|detail|changes)|cards\.(?:snapshot|list|detail|changes))|workbench\.(?:snapshot|changes|history))\.result$/.test(type);
18
+ && /^services\.(?:(?:outputs(?:\.cards)?|panel-cards)\.(?:snapshot|list|detail|changes)|workbench\.(?:snapshot|changes|history))\.result$/.test(type);
19
19
  }
20
20
  /**
21
21
  * SERVICE_REQUEST 与 SERVICE_RESULT 有意重叠:
@@ -49,6 +49,33 @@ export const RESERVED_TYPES = new Set([
49
49
  export function isReservedServiceType(type) {
50
50
  return RESERVED_TYPES.has(type);
51
51
  }
52
+ /**
53
+ * 信封键:只描述「这次投递」本身,不是调用方正文。
54
+ *
55
+ * 它们由演进层/传输层写入,调用方在 `data` 里写这些键一定是误解 —— 而误解不能
56
+ * 静默生效:`--type A --data '{"type":"B"}'` 会把请求路由到 B,调用方拿到一个
57
+ * 看起来合理的回包却调错了对象。`ec services call` 因此在组包前直接拒绝。
58
+ *
59
+ * 只收**纯粹属于信封**的键。`label` / `task_id` / `debug` / `thread_id` 之类虽然也会
60
+ * 被脚本侧剥离,但它们是内置服务可能真正用到的业务字段,拒绝会误伤;那些仍按
61
+ * 既有语义在 `extractServiceData` 里剥离。
62
+ */
63
+ export const SERVICE_ENVELOPE_KEYS = new Set([
64
+ 'type', 'request_id', 'call_id', 'client_signature', 'service_deadline_at_ms', '_evolcore_causation_ref',
65
+ ]);
66
+ /**
67
+ * AUN / EvolCore 注入的传输层字段。脚本契约里 `message.data` 是"调用方传来的正文",
68
+ * 这些字段不是调用方写的,剥掉才能让脚本只面对业务数据(`extractServiceData`)。
69
+ *
70
+ * 是 `SERVICE_ENVELOPE_KEYS` 的超集:多出来的 `chatmode` / `thread_id` / `topic_name` 等
71
+ * 是会话概念,服务调用本就不该有;`label` / `task_id` / `debug` 则可能被内置服务当业务
72
+ * 参数用(内置服务直接读 payload,不走剥离),所以它们只剥不拒 —— 见下方 `SERVICE_ENVELOPE_KEYS`。
73
+ */
74
+ export const SERVICE_TRANSPORT_FIELDS = new Set([
75
+ 'type', 'request_id', 'call_id', 'client_signature', 'service_deadline_at_ms',
76
+ 'chatmode', 'thread_id', 'topic_name', 'topic_status', 'label',
77
+ 'task_id', '_evolcore_causation_ref', 'debug',
78
+ ]);
52
79
  /** listen 校验:末段不得是 result;允许末段整段通配。 */
53
80
  export function isListenableType(type) {
54
81
  if (/\.result$/.test(type))
@@ -27,7 +27,22 @@ function runtimeForExtension(script) {
27
27
  }
28
28
  const TIMEOUT_MIN = 1000;
29
29
  const TIMEOUT_MAX = 300_000;
30
- const TIMEOUT_DEFAULT = 30_000;
30
+ /**
31
+ * handler.name / handler.description 的长度上限。
32
+ *
33
+ * 比包级 `description`(200)更严:这两个字段会进 `services.skill` 的渲染文本,
34
+ * 而 skill 是给**另一个 Agent 读的**。一个包有 10 个 type 时,每个 200 字就是
35
+ * 2000 字噪音。收紧到 24 / 120,并配合 skill 渲染时的单行截断。
36
+ */
37
+ export const HANDLER_NAME_MAX = 24;
38
+ export const HANDLER_DESCRIPTION_MAX = 120;
39
+ /**
40
+ * 脚本默认超时。必须**短于**调用方的等待期(`SERVICE_CALL_TIMEOUT_MS`,12 秒),
41
+ * 否则脚本的默认执行窗口比调用方愿意等的时间还长:每次都必然白跑,
42
+ * 调用方只看到 NO_RESULT 而服务端还在跑。
43
+ */
44
+ export const DEFAULT_HANDLER_TIMEOUT_MS = 10_000;
45
+ const TIMEOUT_DEFAULT = DEFAULT_HANDLER_TIMEOUT_MS;
31
46
  const QUOTA_DEFAULT_BUILTIN = { perMinute: 20, perHour: 200 };
32
47
  const QUOTA_DEFAULT_SERVICE = { perMinute: 50, perHour: 1000 };
33
48
  function isRecord(value) {
@@ -40,10 +55,25 @@ function optionalString(value, field, errors, max) {
40
55
  errors.push(`${field} must be a string`);
41
56
  return undefined;
42
57
  }
58
+ // 带上实际长度:写包的人拿到 "max 120" 还得自己数一遍才能知道超了多少。
43
59
  if (max !== undefined && value.length > max)
44
- errors.push(`${field} is too long (max ${max})`);
60
+ errors.push(`${field} is too long (max ${max}, actual ${value.length})`);
45
61
  return value;
46
62
  }
63
+ /**
64
+ * handler 的展示性文本(`name` / `description`)。
65
+ *
66
+ * 与 `optionalString` 的差别只有一点:**纯空白视为未声明**。这两个字段只用于展示,
67
+ * 写一个空串和没写没有任何区别;保留空串反而会让 `describe` 输出里出现
68
+ * `"name": ""`,调用方无法区分「有标题但为空」和「没标题」。
69
+ */
70
+ function optionalLabel(value, field, max, errors) {
71
+ const text = optionalString(value, field, errors, max);
72
+ if (text === undefined)
73
+ return undefined;
74
+ const trimmed = text.trim();
75
+ return trimmed ? trimmed : undefined;
76
+ }
47
77
  function intInRange(value, field, min, max, errors) {
48
78
  if (typeof value !== 'number' || !Number.isInteger(value) || value < min || value > max) {
49
79
  errors.push(`${field} must be an integer between ${min} and ${max}`);
@@ -113,15 +143,40 @@ function validateScriptPath(script, errors) {
113
143
  }
114
144
  return script;
115
145
  }
146
+ /**
147
+ * 声明式 schema 片段:只要是对象就原样收下。
148
+ *
149
+ * 不在这里校验 JSON Schema 本身合法——那需要一整套 meta-schema,而它的唯一收益是
150
+ * 把"作者写错 schema"从运行期提前到装包期;代价是框架必须持续跟进规范版本。
151
+ * 现阶段选择透传,错误由调用方(或作者自测)发现。
152
+ */
153
+ function optionalSchema(raw, field, errors) {
154
+ if (raw === undefined)
155
+ return undefined;
156
+ if (!isRecord(raw)) {
157
+ errors.push(`${field} must be an object (a JSON Schema fragment)`);
158
+ return undefined;
159
+ }
160
+ return raw;
161
+ }
116
162
  function validateHandler(raw, errors) {
117
163
  if (!isRecord(raw)) {
118
164
  errors.push('listen[].handler must be an object');
119
165
  return undefined;
120
166
  }
121
- const extra = Object.keys(raw).filter(key => !['script', 'runtime', 'args', 'timeoutMs'].includes(key));
167
+ const extra = Object.keys(raw).filter(key => ![
168
+ 'script', 'runtime', 'args', 'timeoutMs', 'name', 'description', 'mode', 'resident',
169
+ 'inputSchema', 'outputSchema',
170
+ ].includes(key));
122
171
  if (extra.length)
123
172
  errors.push(`listen[].handler has unknown fields: ${extra.join(', ')}`);
173
+ // schema 只校验"是个对象":内容原样透传给调用方,不在框架里解释。
174
+ // 想校验就去包作者自己的脚本里校验——两处各写一份必然漂移。
175
+ const inputSchema = optionalSchema(raw.inputSchema, 'listen[].handler.inputSchema', errors);
176
+ const outputSchema = optionalSchema(raw.outputSchema, 'listen[].handler.outputSchema', errors);
124
177
  const script = validateScriptPath(raw.script, errors);
178
+ const name = optionalLabel(raw.name, 'listen[].handler.name', HANDLER_NAME_MAX, errors);
179
+ const description = optionalLabel(raw.description, 'listen[].handler.description', HANDLER_DESCRIPTION_MAX, errors);
125
180
  if (raw.runtime !== undefined && !RUNTIME_WHITELIST.includes(raw.runtime)) {
126
181
  errors.push(`listen[].handler.runtime must be one of ${RUNTIME_WHITELIST.join('/')}`);
127
182
  }
@@ -140,6 +195,7 @@ function validateHandler(raw, errors) {
140
195
  const timeoutMs = raw.timeoutMs === undefined
141
196
  ? TIMEOUT_DEFAULT
142
197
  : intInRange(raw.timeoutMs, 'listen[].handler.timeoutMs', TIMEOUT_MIN, TIMEOUT_MAX, errors);
198
+ const mode = validateHandlerMode(raw.mode, raw.resident, errors);
143
199
  if (script === undefined)
144
200
  return undefined;
145
201
  return {
@@ -147,6 +203,62 @@ function validateHandler(raw, errors) {
147
203
  ...(raw.runtime !== undefined ? { runtime: raw.runtime } : {}),
148
204
  ...(Array.isArray(raw.args) ? { args: raw.args } : {}),
149
205
  timeoutMs: timeoutMs ?? TIMEOUT_DEFAULT,
206
+ ...(name !== undefined ? { name } : {}),
207
+ ...(description !== undefined ? { description } : {}),
208
+ ...(inputSchema !== undefined ? { inputSchema } : {}),
209
+ ...(outputSchema !== undefined ? { outputSchema } : {}),
210
+ ...(mode !== undefined ? { mode: mode.mode } : {}),
211
+ ...(mode?.resident ? { resident: mode.resident } : {}),
212
+ };
213
+ }
214
+ /**
215
+ * `handler.mode` / `handler.resident` 校验。
216
+ *
217
+ * `resident` 子对象只在 `mode:"resident"` 时有意义——其他形态下出现就报错,
218
+ * 因为静默忽略会让作者以为调参生效了,而实际写的是个死配置。
219
+ */
220
+ function validateHandlerMode(rawMode, rawResident, errors) {
221
+ if (rawMode !== undefined && rawMode !== 'spawn' && rawMode !== 'resident') {
222
+ errors.push('listen[].handler.mode must be "spawn" or "resident"');
223
+ return undefined;
224
+ }
225
+ // 未声明时**不落默认值**:让"没写"与"显式写 spawn"在输出里可区分——
226
+ // 否则 describe/status 会显示一个用户从未写过的 mode,排查时容易误判。
227
+ const declared = rawMode === 'spawn' || rawMode === 'resident' ? rawMode : undefined;
228
+ const mode = declared ?? 'spawn';
229
+ if (rawResident === undefined)
230
+ return declared ? { mode: declared } : undefined;
231
+ if (mode !== 'resident') {
232
+ errors.push('listen[].handler.resident is only meaningful when handler.mode is "resident"');
233
+ return declared ? { mode: declared } : undefined;
234
+ }
235
+ if (!isRecord(rawResident)) {
236
+ errors.push('listen[].handler.resident must be an object');
237
+ return { mode: declared };
238
+ }
239
+ const extra = Object.keys(rawResident).filter(key => !['startTimeoutMs', 'softTimeoutMs', 'hardTimeoutAfter'].includes(key));
240
+ if (extra.length)
241
+ errors.push(`listen[].handler.resident has unknown fields: ${extra.join(', ')}`);
242
+ const startTimeoutMs = rawResident.startTimeoutMs === undefined
243
+ ? undefined
244
+ : intInRange(rawResident.startTimeoutMs, 'listen[].handler.resident.startTimeoutMs', TIMEOUT_MIN, 120_000, errors);
245
+ const softTimeoutMs = rawResident.softTimeoutMs === undefined
246
+ ? undefined
247
+ : intInRange(rawResident.softTimeoutMs, 'listen[].handler.resident.softTimeoutMs', TIMEOUT_MIN, TIMEOUT_MAX, errors);
248
+ const hardTimeoutAfter = rawResident.hardTimeoutAfter === undefined
249
+ ? undefined
250
+ : intInRange(rawResident.hardTimeoutAfter, 'listen[].handler.resident.hardTimeoutAfter', 1, 100, errors);
251
+ return {
252
+ ...(declared ? { mode: declared } : {}),
253
+ ...((startTimeoutMs ?? softTimeoutMs ?? hardTimeoutAfter) !== undefined
254
+ ? {
255
+ resident: {
256
+ ...(startTimeoutMs !== undefined ? { startTimeoutMs } : {}),
257
+ ...(softTimeoutMs !== undefined ? { softTimeoutMs } : {}),
258
+ ...(hardTimeoutAfter !== undefined ? { hardTimeoutAfter } : {}),
259
+ },
260
+ }
261
+ : {}),
150
262
  };
151
263
  }
152
264
  function validateListenEntry(raw, errors) {
@@ -366,7 +478,7 @@ export function validateRouterConfig(raw) {
366
478
  const errors = [];
367
479
  if (!isRecord(raw))
368
480
  return { ok: false, errors: ['services-config.json must be a JSON object'] };
369
- const extra = Object.keys(raw).filter(key => !['v', 'enabled', 'rateLimit', 'rules'].includes(key));
481
+ const extra = Object.keys(raw).filter(key => !['v', 'enabled', 'rateLimit', 'rules', 'host'].includes(key));
370
482
  if (extra.length)
371
483
  errors.push(`unknown top-level fields: ${extra.join(', ')}`);
372
484
  if (raw.v !== 1)
@@ -391,11 +503,30 @@ export function validateRouterConfig(raw) {
391
503
  }
392
504
  }
393
505
  const rules = validateRules(raw.rules, errors);
506
+ const host = validateHostConfig(raw.host, errors);
394
507
  if (errors.length)
395
508
  return { ok: false, errors };
396
509
  return {
397
510
  ok: true,
398
511
  errors: [],
399
- value: { v: 1, enabled: raw.enabled !== false, rateLimit, rules },
512
+ value: { v: 1, enabled: raw.enabled !== false, rateLimit, rules, ...(host ? { host } : {}) },
400
513
  };
401
514
  }
515
+ /**
516
+ * `host` 段。当前只认 `enabled`;P3 的自管理参数(空闲窗口、间隔分级)上线时在这里扩,
517
+ * **未知字段一律报错**——静默忽略会让用户以为开关生效了。
518
+ */
519
+ function validateHostConfig(raw, errors) {
520
+ if (raw === undefined)
521
+ return undefined;
522
+ if (!isRecord(raw)) {
523
+ errors.push('host must be an object');
524
+ return undefined;
525
+ }
526
+ const extra = Object.keys(raw).filter(key => key !== 'enabled');
527
+ if (extra.length)
528
+ errors.push(`host has unknown fields: ${extra.join(', ')}`);
529
+ if (raw.enabled !== undefined && typeof raw.enabled !== 'boolean')
530
+ errors.push('host.enabled must be a boolean');
531
+ return { ...(raw.enabled !== undefined ? { enabled: raw.enabled } : {}) };
532
+ }
@@ -0,0 +1,110 @@
1
+ import { contextTokensForUsage } from '../core/baseagent/runner-types.js';
2
+ import { resolveRoot } from '../paths.js';
3
+ import { logger } from '../utils/logger.js';
4
+ import { getDbPath, openReadonlyDb } from './db.js';
5
+ export function formatCompactingNotice(totalTokens) {
6
+ if (typeof totalTokens !== 'number' || !Number.isFinite(totalTokens) || totalTokens <= 0) {
7
+ return '当前会话正在压缩中…';
8
+ }
9
+ return `当前会话已到${Math.round(totalTokens / 1_000)}k,正在压缩中…`;
10
+ }
11
+ export async function readLastModelCallContextUsage(sessionId, agentSessionId) {
12
+ try {
13
+ const { getDb, openReadonlyDb, getDbPath } = await import('./db.js');
14
+ const root = resolveRoot();
15
+ const writerDb = getDb(root);
16
+ const db = writerDb || openReadonlyDb(getDbPath(root));
17
+ if (!db)
18
+ return undefined;
19
+ const shouldClose = !writerDb;
20
+ try {
21
+ const row = db.prepare(`SELECT model, input_tokens, output_tokens, cache_creation_tokens, cache_read_tokens,
22
+ context_tokens, max_tokens
23
+ FROM model_calls
24
+ WHERE session_id = ?
25
+ AND agent_session_id = ?
26
+ AND COALESCE(degraded, 0) = 0
27
+ ORDER BY ts DESC, call_index DESC
28
+ LIMIT 1`).get(sessionId, agentSessionId);
29
+ if (!row)
30
+ return undefined;
31
+ const model = row.model || '';
32
+ const recordedTotalTokens = row.context_tokens ?? undefined;
33
+ let totalTokens;
34
+ if (recordedTotalTokens && recordedTotalTokens > 0) {
35
+ totalTokens = recordedTotalTokens;
36
+ }
37
+ else {
38
+ totalTokens = contextTokensForUsage({
39
+ input_tokens: row.input_tokens,
40
+ output_tokens: row.output_tokens,
41
+ cache_creation_input_tokens: row.cache_creation_tokens,
42
+ cache_read_input_tokens: row.cache_read_tokens,
43
+ }, model);
44
+ }
45
+ if (totalTokens <= 0)
46
+ return undefined;
47
+ const maxTokens = row.max_tokens ?? 0;
48
+ if (!(recordedTotalTokens && recordedTotalTokens > 0) && maxTokens > 0 && totalTokens > maxTokens * 1.05) {
49
+ logger.warn(`[ContextUsage] Ignoring implausible context_tokens: session=${sessionId} totalTokens=${totalTokens} maxTokens=${maxTokens}`);
50
+ return undefined;
51
+ }
52
+ return { totalTokens };
53
+ }
54
+ finally {
55
+ if (shouldClose)
56
+ db.close();
57
+ }
58
+ }
59
+ catch (err) {
60
+ logger.debug(`[ContextUsage] Failed to read last model call context usage: ${err}`);
61
+ return undefined;
62
+ }
63
+ }
64
+ /** Latest matching recorded turn, not a live query or a compaction threshold. */
65
+ export function readRecordedCodexContextWindow(root, self, model, provider, configuredThreshold) {
66
+ const db = openReadonlyDb(getDbPath(root));
67
+ if (!db)
68
+ return undefined;
69
+ try {
70
+ // Configured runs record their requested compact limit. Do not reuse an
71
+ // enlarged run after reset, a different Provider, or another Agent's data.
72
+ const row = db.prepare(`SELECT ts, max_tokens FROM model_calls
73
+ WHERE agent_aid = ? AND model = ? AND provider_id IS ?
74
+ AND source = 'turn' AND auto_compact_tokens IS ?
75
+ ORDER BY ts DESC, call_index DESC, id DESC LIMIT 1`)
76
+ .get(self, model, provider, configuredThreshold);
77
+ if (!row || !Number.isSafeInteger(row.max_tokens) || row.max_tokens < 1)
78
+ return undefined;
79
+ return { tokens: row.max_tokens, recordedAt: row.ts };
80
+ }
81
+ catch {
82
+ // Older/missing statistics must never prevent reading or changing config.
83
+ return undefined;
84
+ }
85
+ finally {
86
+ db.close();
87
+ }
88
+ }
89
+ /** Latest native window for the selected Agent/model/Provider, regardless of
90
+ * whether that turn used a previous compaction override. */
91
+ export function readLatestCodexContextWindow(root, self, model, provider) {
92
+ const db = openReadonlyDb(getDbPath(root));
93
+ if (!db)
94
+ return undefined;
95
+ try {
96
+ const row = db.prepare(`SELECT ts, max_tokens, auto_compact_tokens FROM model_calls
97
+ WHERE agent_aid = ? AND model = ? AND provider_id IS ? AND source = 'turn'
98
+ ORDER BY ts DESC, call_index DESC, id DESC LIMIT 1`)
99
+ .get(self, model, provider);
100
+ if (!row || !Number.isSafeInteger(row.max_tokens) || row.max_tokens < 1)
101
+ return undefined;
102
+ return { tokens: row.max_tokens, recordedAt: row.ts, autoCompactTokens: row.auto_compact_tokens };
103
+ }
104
+ catch {
105
+ return undefined;
106
+ }
107
+ finally {
108
+ db.close();
109
+ }
110
+ }
@@ -19,6 +19,13 @@ export function normalizeUsdToCny(raw) {
19
19
  export function roundCostForOutput(value) {
20
20
  return Number.isFinite(value) ? Number(value.toFixed(4)) : value;
21
21
  }
22
+ /** 保留未计价状态,避免回执把官方价冒充网关价或把未知费用显示成零。 */
23
+ export function pricePairForOutput(prices) {
24
+ const round = (cost) => cost
25
+ ? { usd: roundCostForOutput(cost.usd), cny: roundCostForOutput(cost.cny) }
26
+ : null;
27
+ return { official: round(prices.official), gateway: round(prices.gateway) };
28
+ }
22
29
  // 模型参数缓存(进程内,5 分钟 TTL)
23
30
  let _parameterCache = null;
24
31
  let _parameterCacheTs = 0;
@@ -480,7 +487,70 @@ const GATEWAY_PRICING_TTL_MS = 60 * 60 * 1000; // 1h
480
487
  /** key: baseUrl */
481
488
  const gatewayPricingCache = new Map();
482
489
  /** 去重并发刷新 */
483
- const gatewayPricingInFlight = new Set();
490
+ const gatewayPricingInFlight = new Map();
491
+ export const OFFICIAL_PRICING_REFERENCE_URL = 'https://mg-new.evolai.cn/claude-proxy/v1/models';
492
+ let officialPricingReference;
493
+ let officialPricingReferenceRefreshAt = 0;
494
+ let officialPricingReferenceInFlight;
495
+ /** 不携带当前 Provider 的 key/headers,不读取参考端点的 effective_pricing 或能力参数。 */
496
+ async function loadOfficialPricingReference() {
497
+ if (Date.now() < officialPricingReferenceRefreshAt)
498
+ return;
499
+ if (officialPricingReferenceInFlight)
500
+ return officialPricingReferenceInFlight;
501
+ officialPricingReferenceInFlight = (async () => {
502
+ const controller = new AbortController();
503
+ const timer = setTimeout(() => controller.abort(), 5000);
504
+ try {
505
+ const response = await fetch(OFFICIAL_PRICING_REFERENCE_URL, { signal: controller.signal });
506
+ if (!response.ok)
507
+ throw new Error(`HTTP ${response.status}`);
508
+ const json = await response.json();
509
+ const models = Array.isArray(json?.data) ? json.data : Array.isArray(json?.models) ? json.models : [];
510
+ const prices = new Map();
511
+ for (const model of models) {
512
+ const id = model?.id || model?.name || model?.model;
513
+ const quad = apiPricingToQuad(model?.pricing);
514
+ if (typeof id === 'string' && quad)
515
+ prices.set(id, quad);
516
+ }
517
+ if (!prices.size)
518
+ throw new Error('No official prices');
519
+ officialPricingReference = { prices, usdToCny: normalizeUsdToCny(json?.usd_to_cny) };
520
+ officialPricingReferenceRefreshAt = Date.now() + GATEWAY_PRICING_TTL_MS;
521
+ logger.info(`[OfficialPricing] Refreshed reference ${OFFICIAL_PRICING_REFERENCE_URL}: models=${prices.size}`);
522
+ }
523
+ catch (error) {
524
+ // 保留最近成功的参考价;失败时短暂退避,未知价格保持空值。
525
+ officialPricingReferenceRefreshAt = Date.now() + 60_000;
526
+ logger.warn(`[OfficialPricing] Reference unavailable: ${error instanceof Error ? error.message : String(error)}`);
527
+ }
528
+ finally {
529
+ clearTimeout(timer);
530
+ }
531
+ })();
532
+ try {
533
+ await officialPricingReferenceInFlight;
534
+ }
535
+ finally {
536
+ officialPricingReferenceInFlight = undefined;
537
+ }
538
+ }
539
+ /** 写入用量前等待首轮目录刷新,并为缺官方价的模型准备独立参考价。 */
540
+ export async function prepareUsagePricing(pricing, models) {
541
+ const baseUrl = pricing?.source?.baseUrl;
542
+ if (!pricing)
543
+ return pricing;
544
+ if (baseUrl)
545
+ await gatewayPricingInFlight.get(baseUrl);
546
+ const latest = baseUrl ? gatewayPricingCache.get(baseUrl)?.cache : undefined;
547
+ if (latest)
548
+ pricing = { ...latest, source: pricing.source };
549
+ if (models.every(model => pickGatewayQuad(resolveRoot(), pricing.official, model)))
550
+ return pricing;
551
+ await loadOfficialPricingReference();
552
+ return { ...pricing, officialFallback: officialPricingReference ?? { prices: new Map() } };
553
+ }
484
554
  /**
485
555
  * 把 /v1/models 单个 model 的价格对象转为 PriceQuad。
486
556
  * 单位假设:接口价与 model-prices.jsonl 同口径(USD per 1M token),不做换算。
@@ -488,7 +558,7 @@ const gatewayPricingInFlight = new Set();
488
558
  export function apiPricingToQuad(p) {
489
559
  if (!p || typeof p !== 'object')
490
560
  return undefined;
491
- const n = (v) => (typeof v === 'number' && isFinite(v) ? v : undefined);
561
+ const n = (v) => (typeof v === 'number' && isFinite(v) && v >= 0 ? v : undefined);
492
562
  const quad = {
493
563
  input: n(p.input),
494
564
  output: n(p.output),
@@ -505,14 +575,20 @@ export function apiPricingToQuad(p) {
505
575
  * 拉取网关 /v1/models 的官方价(pricing) + 网关价(effective_pricing),写入缓存。
506
576
  * 失败静默——保持回退到本地价表 / official。
507
577
  */
508
- export async function refreshGatewayPricing(baseUrl, apiKey, requestHeaders) {
509
- if (gatewayPricingInFlight.has(baseUrl))
510
- return;
511
- gatewayPricingInFlight.add(baseUrl);
578
+ export function refreshGatewayPricing(baseUrl, apiKey, requestHeaders) {
579
+ const pending = gatewayPricingInFlight.get(baseUrl);
580
+ if (pending)
581
+ return pending;
582
+ const refresh = fetchGatewayPricing(baseUrl, apiKey, requestHeaders)
583
+ .finally(() => { gatewayPricingInFlight.delete(baseUrl); });
584
+ gatewayPricingInFlight.set(baseUrl, refresh);
585
+ return refresh;
586
+ }
587
+ async function fetchGatewayPricing(baseUrl, apiKey, requestHeaders) {
588
+ const controller = new AbortController();
589
+ const timer = setTimeout(() => controller.abort(), 5000);
512
590
  try {
513
591
  const url = `${baseUrl.replace(/\/+$/, '')}/v1/models`;
514
- const controller = new AbortController();
515
- const timer = setTimeout(() => controller.abort(), 5000);
516
592
  const resp = await fetch(url, {
517
593
  signal: controller.signal,
518
594
  headers: {
@@ -520,7 +596,6 @@ export async function refreshGatewayPricing(baseUrl, apiKey, requestHeaders) {
520
596
  ...requestHeaders,
521
597
  },
522
598
  });
523
- clearTimeout(timer);
524
599
  if (!resp.ok)
525
600
  return;
526
601
  const json = await resp.json();
@@ -552,16 +627,15 @@ export async function refreshGatewayPricing(baseUrl, apiKey, requestHeaders) {
552
627
  .map(m => (typeof m === 'string' ? m : (m?.id || m?.name || m?.model)))
553
628
  .filter((id) => typeof id === 'string' && !!id);
554
629
  saveProviderAliases(resolveRoot(), baseUrl, json?.model_aliases, knownIds);
555
- if (official.size > 0 || gateway.size > 0) {
556
- gatewayPricingCache.set(baseUrl, { cache: { official, gateway, usdToCny }, fetchedAt: Date.now() });
557
- logger.info(`[GatewayPricing] Refreshed from ${url}: official=${official.size} gateway=${gateway.size} usd_to_cny=${usdToCny ?? `(default ${DEFAULT_USD_TO_CNY})`}`);
558
- }
630
+ // 空价目也要缓存,避免没有 pricing 的网关每次用量结算都重拉目录。
631
+ gatewayPricingCache.set(baseUrl, { cache: { official, gateway, usdToCny }, fetchedAt: Date.now() });
632
+ logger.info(`[GatewayPricing] Refreshed from ${url}: official=${official.size} gateway=${gateway.size} usd_to_cny=${usdToCny ?? `(default ${DEFAULT_USD_TO_CNY})`}`);
559
633
  }
560
634
  catch {
561
635
  // 网络/解析失败:保持回退,不打断查询
562
636
  }
563
637
  finally {
564
- gatewayPricingInFlight.delete(baseUrl);
638
+ clearTimeout(timer);
565
639
  }
566
640
  }
567
641
  /**
@@ -575,7 +649,8 @@ export function getGatewayPricing(baseUrl, apiKey, requestHeaders) {
575
649
  if (!entry || Date.now() - entry.fetchedAt > GATEWAY_PRICING_TTL_MS) {
576
650
  void refreshGatewayPricing(baseUrl, apiKey, requestHeaders); // 不 await,stale-while-revalidate
577
651
  }
578
- return entry?.cache;
652
+ // 即使首轮目录尚未返回,也保留实际 Provider,供结算等待刷新及决定参考价回退。
653
+ return { ...(entry?.cache ?? { official: new Map(), gateway: new Map() }), source: { baseUrl } };
579
654
  }
580
655
  // 网关价格表缓存(从用户覆盖层 model-prices-gateway.jsonl 读取)
581
656
  let _gatewayPriceCache = null;
@@ -626,7 +701,7 @@ function resolveGatewayPriceRow(evolcoreHome, model, ts) {
626
701
  * 从网关价格 Map 里取价:Map 的键是网关原样下发的 ID(可能带 `[1m]` 后缀),
627
702
  * 而 usage 事件记录的可能是基础 ID,反之亦然——两侧都要按候选键链匹配。
628
703
  */
629
- function pickGatewayQuad(evolcoreHome, map, model) {
704
+ export function pickGatewayQuad(evolcoreHome, map, model) {
630
705
  if (!map)
631
706
  return null;
632
707
  for (const key of modelLookupKeys(evolcoreHome, model)) {
@@ -664,6 +739,17 @@ function priceQuadToRecord(model, ts, quad, billing_fn, currency = 'USD') {
664
739
  * @returns 官方价格和网关价格的费用对
665
740
  */
666
741
  export function resolvePrices(evolcoreHome, event, gatewayPricing) {
742
+ const directOfficial = pickGatewayQuad(evolcoreHome, gatewayPricing?.official, event.model);
743
+ const usingReference = gatewayPricing?.officialFallback !== undefined && !directOfficial;
744
+ if (usingReference) {
745
+ const quad = pickGatewayQuad(evolcoreHome, gatewayPricing.officialFallback.prices, event.model);
746
+ const fn = BILLING_FNS[event.billing_fn];
747
+ if (!quad || !fn)
748
+ return { official: null, gateway: null };
749
+ const cost = fn(event, priceQuadToRecord(event.model, event.ts, quad, event.billing_fn));
750
+ const rate = normalizeUsdToCny(gatewayPricing.officialFallback.usdToCny) ?? DEFAULT_USD_TO_CNY;
751
+ return { official: { usd: cost.usd ?? (cost.cny ?? 0) / rate, cny: cost.cny ?? (cost.usd ?? 0) * rate }, gateway: null };
752
+ }
667
753
  // ── 1. 官方价格(Official Price)──────────────────────────────────────────
668
754
  let officialCost = null;
669
755
  // 优先级 0: 模型别名命中本地价表。Evol 等中转到官方同名模型时,
@@ -679,7 +765,7 @@ export function resolvePrices(evolcoreHome, event, gatewayPricing) {
679
765
  }
680
766
  }
681
767
  // 优先级 1: 网关接口返回的 pricing 字段
682
- const officialQuad = officialCost ? null : pickGatewayQuad(evolcoreHome, gatewayPricing?.official, event.model);
768
+ const officialQuad = officialCost ? null : directOfficial;
683
769
  if (officialQuad) {
684
770
  const priceRow = priceQuadToRecord(event.model, event.ts, officialQuad, event.billing_fn);
685
771
  const fn = BILLING_FNS[event.billing_fn];
@@ -559,6 +559,7 @@ export function querySessionSummary(evolcoreHome, sessionId) {
559
559
  total_tokens: 0, calls: 0,
560
560
  cost_official_usd: 0, cost_official_cny: 0, cost_gateway_usd: 0, cost_gateway_cny: 0,
561
561
  usd: 0, cny: 0,
562
+ officialPricedCalls: 0, gatewayPricedCalls: 0,
562
563
  };
563
564
  const sql = `
564
565
  SELECT
@@ -567,6 +568,8 @@ export function querySessionSummary(evolcoreHome, sessionId) {
567
568
  COALESCE(SUM(cache_creation_tokens), 0) AS cache_creation_tokens,
568
569
  COALESCE(SUM(cache_read_tokens), 0) AS cache_read_tokens,
569
570
  COUNT(*) AS calls,
571
+ COUNT(cost_official_usd) AS officialPricedCalls,
572
+ COUNT(cost_gateway_usd) AS gatewayPricedCalls,
570
573
  COALESCE(SUM(cost_official_usd), 0) AS cost_official_usd,
571
574
  COALESCE(SUM(cost_official_cny), 0) AS cost_official_cny,
572
575
  COALESCE(SUM(cost_gateway_usd), 0) AS cost_gateway_usd,
@@ -586,6 +589,8 @@ export function querySessionSummary(evolcoreHome, sessionId) {
586
589
  acc.cache_creation_tokens += r.cache_creation_tokens ?? 0;
587
590
  acc.cache_read_tokens += r.cache_read_tokens ?? 0;
588
591
  acc.calls += r.calls ?? 0;
592
+ acc.officialPricedCalls += r.officialPricedCalls ?? 0;
593
+ acc.gatewayPricedCalls += r.gatewayPricedCalls ?? 0;
589
594
  acc.cost_official_usd += r.cost_official_usd ?? 0;
590
595
  acc.cost_official_cny += r.cost_official_cny ?? 0;
591
596
  acc.cost_gateway_usd += r.cost_gateway_usd ?? 0;
@@ -1,8 +1,8 @@
1
1
  import { consolidationCheckCron, removeConsolidationCheckTrigger, seedConsolidationCheckTrigger } from '../core/memory/consolidation-trigger.js';
2
- import { tryParseChannelKey } from '../core/channel-loader.js';
2
+ import { tryParseChannelKey } from '../core/channel/channel-loader.js';
3
3
  import { TriggerDefinitionManager } from './manager.js';
4
4
  import { TriggerRunStateStore } from './state.js';
5
- import { removeLegacyAgentUpgradeCheck, seedSessionIdleCheckTrigger, seedTaskRecoveryTrigger, seedUpgradeCheckTrigger, } from './system-definitions.js';
5
+ import { removeLegacyAgentUpgradeCheck, seedSessionIdleCheckTrigger, seedTaskRecoveryTrigger, seedUpgradeCheckTrigger, seedAgentTemplateCheckTrigger, } from './system-definitions.js';
6
6
  import { TriggerFeedbackDispatcher } from './feedback.js';
7
7
  import { TriggerRuntimeScheduler } from './scheduler.js';
8
8
  import { logger } from '../utils/logger.js';
@@ -41,12 +41,12 @@ export class TriggerSchedulerRegistry {
41
41
  }
42
42
  return { enabled, today: { calls, failures } };
43
43
  }
44
- async replace(agentAid, createScheduler) {
44
+ async replace(agentAid, createScheduler, admit) {
45
45
  await this.schedulers.get(agentAid)?.stop();
46
46
  const scheduler = createScheduler();
47
47
  this.schedulers.set(agentAid, scheduler);
48
48
  try {
49
- await scheduler.init();
49
+ await scheduler.init(admit);
50
50
  }
51
51
  catch (error) {
52
52
  logger.error(`[Trigger] Scheduler init failed for ${agentAid}: ${error instanceof Error ? error.message : String(error)}`);
@@ -86,8 +86,10 @@ export class TriggerSchedulerRegistry {
86
86
  await Promise.all([...this.schedulers.values()].map(scheduler => scheduler.waitForIdle(timeoutMs)));
87
87
  }
88
88
  async suspendForDaemonExit() {
89
- await this.notify(listener => listener.suspending?.());
90
- await Promise.all([...this.schedulers.values()].map(scheduler => scheduler.suspendForDaemonExit()));
89
+ // Mark all resumable runs suspended before yielding: daemon queue interruption
90
+ // starts as soon as this method returns its promise. Listeners may be async.
91
+ const suspending = [...this.schedulers.values()].map(scheduler => scheduler.suspendForDaemonExit());
92
+ await Promise.all([...suspending, this.notify(listener => listener.suspending?.())]);
91
93
  }
92
94
  }
93
95
  export function createTriggerChannelResolver({ agentRegistry, channelInstances, daemonChannel, daemonTriggerOwner, }) {
@@ -111,6 +113,7 @@ export function buildTriggerScheduler(owner, dependencies, options = {}) {
111
113
  const manager = new TriggerDefinitionManager(owner.aid);
112
114
  if (options.seedUpgradeCheck) {
113
115
  seedUpgradeCheckTrigger(manager, owner);
116
+ seedAgentTemplateCheckTrigger(manager, owner);
114
117
  seedTaskRecoveryTrigger(manager, owner);
115
118
  seedSessionIdleCheckTrigger(manager, owner);
116
119
  }