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
@@ -0,0 +1,154 @@
1
+ import fs from 'fs';
2
+ import path from 'path';
3
+ import { execFile } from 'child_process';
4
+ import { promisify } from 'util';
5
+ import { withFileLock } from './atomic-write.js';
6
+ import { getProcessStartTime, startTimeMatches } from './process-introspect.js';
7
+ import { readRestartRequest, updateRestartRequest } from './restart-safety.js';
8
+ const execFileAsync = promisify(execFile);
9
+ const SHOW_PROPERTIES = 'Id,LoadState,ActiveState,MainPID,ControlGroup,InvocationID';
10
+ function processCgroup(pid) {
11
+ const groups = fs.readFileSync(`/proc/${pid}/cgroup`, 'utf8').trim().split('\n')
12
+ .map(line => line.match(/^\d+:([^:]*):(\/.*)$/))
13
+ .filter(match => match && (match[1] === '' || match[1].split(',').includes('name=systemd')))
14
+ .map(match => match[2]);
15
+ if (groups.length !== 1 || path.posix.normalize(groups[0]) !== groups[0]) {
16
+ throw new Error(`Cannot determine systemd cgroup for daemon PID ${pid}`);
17
+ }
18
+ return groups[0];
19
+ }
20
+ function assertIdentity(pid, startedAt) {
21
+ if (!Number.isInteger(pid) || pid <= 1 || !Number.isFinite(startedAt)
22
+ || !startTimeMatches(startedAt, getProcessStartTime(pid, { fresh: true }))) {
23
+ throw new Error(`Daemon identity changed or is unavailable (PID ${pid}); refusing systemd restart`);
24
+ }
25
+ }
26
+ function hasAncestor(pid, ancestor) {
27
+ const visited = new Set();
28
+ while (pid > 1 && visited.size < 64 && !visited.has(pid)) {
29
+ if (pid === ancestor)
30
+ return true;
31
+ visited.add(pid);
32
+ const stat = fs.readFileSync(`/proc/${pid}/stat`, 'utf8');
33
+ pid = Number(stat.slice(stat.lastIndexOf(')') + 2).split(' ')[1]);
34
+ }
35
+ return false;
36
+ }
37
+ function scopeArgs(scope) {
38
+ return scope === 'user' ? ['--user'] : ['--system'];
39
+ }
40
+ /** Inspect the target daemon, never the calling CLI's cgroup or environment. */
41
+ export async function discoverSystemdService(pid, startedAt) {
42
+ if (process.platform !== 'linux')
43
+ return null;
44
+ assertIdentity(pid, startedAt);
45
+ const controlGroup = processCgroup(pid);
46
+ // The innermost unit owns the process. An ancestor user@/docker service is
47
+ // not ownership when a session/container scope is nested underneath it.
48
+ const units = controlGroup.split('/').filter(part => /\.(service|scope)$/.test(part));
49
+ const unit = units.at(-1);
50
+ if (!unit?.endsWith('.service'))
51
+ return null;
52
+ if (!/^[a-zA-Z0-9_:@.\\-]+\.service$/.test(unit) || unit.startsWith('-')) {
53
+ throw new Error('Invalid systemd service name in daemon cgroup');
54
+ }
55
+ // A container may expose a host cgroup while having its own PID namespace.
56
+ // Never ask a host/container manager to restart an enclosing host service.
57
+ if (fs.readFileSync('/proc/1/comm', 'utf8').trim() !== 'systemd') {
58
+ throw new Error('Daemon has a service cgroup but its systemd manager is not visible; restart from the owning host');
59
+ }
60
+ const userManager = controlGroup.match(/\/user@(\d+)\.service\//);
61
+ const scope = userManager ? 'user' : 'system';
62
+ if (userManager && Number(userManager[1]) !== process.getuid?.()) {
63
+ throw new Error('User systemd restart requires the owning user and its user manager');
64
+ }
65
+ const { stdout } = await execFileAsync('systemctl', [
66
+ ...scopeArgs(scope), '--no-ask-password', 'show', `--property=${SHOW_PROPERTIES}`, '--', unit,
67
+ ], { encoding: 'utf8', timeout: 5_000, maxBuffer: 64 * 1024 });
68
+ const properties = Object.fromEntries(stdout.trim().split('\n').map(line => {
69
+ const equals = line.indexOf('=');
70
+ return [line.slice(0, equals), line.slice(equals + 1)];
71
+ }));
72
+ const mainPid = Number(properties.MainPID);
73
+ if (properties.Id !== unit || properties.LoadState !== 'loaded' || properties.ActiveState !== 'active'
74
+ || properties.ControlGroup !== controlGroup
75
+ || !/^[a-f0-9]{32}$/.test(properties.InvocationID)
76
+ || !Number.isInteger(mainPid) || mainPid <= 1
77
+ || !hasAncestor(pid, mainPid) || processCgroup(mainPid) !== controlGroup) {
78
+ throw new Error(`Cannot verify daemon ownership by ${scope} unit ${unit}; service was not stopped`);
79
+ }
80
+ const command = fs.readFileSync(`/proc/${mainPid}/cmdline`, 'utf8').split('\0');
81
+ if (!command.includes('start') || !command.includes('--foreground')) {
82
+ throw new Error(`Unit ${unit} does not run start --foreground; automatic systemd restart is unsupported`);
83
+ }
84
+ assertIdentity(pid, startedAt);
85
+ return { scope, unit, controlGroup, invocationId: properties.InvocationID, mainPid, daemonPid: pid, daemonStartedAt: startedAt };
86
+ }
87
+ /** Persist ownership before submission: systemd can kill this caller before execFile resolves. */
88
+ export async function submitSystemdRestart(file, requestId, service) {
89
+ await withFileLock(`${file}.systemd.lock`, async () => {
90
+ const pending = readRestartRequest(file, requestId);
91
+ if (!pending || pending.status !== 'requested' || pending.backend) {
92
+ throw new Error('Restart request changed or was already submitted');
93
+ }
94
+ const current = await discoverSystemdService(service.daemonPid, service.daemonStartedAt);
95
+ if (!current || current.invocationId !== service.invocationId || current.unit !== service.unit
96
+ || current.scope !== service.scope || current.controlGroup !== service.controlGroup) {
97
+ throw new Error('Systemd ownership changed before restart submission');
98
+ }
99
+ if (!updateRestartRequest(file, requestId, {
100
+ backend: 'systemd', systemd: service, deadline: Date.now() + 120_000,
101
+ }))
102
+ throw new Error('Restart request changed before systemd submission');
103
+ try {
104
+ await execFileAsync('systemctl', [
105
+ ...scopeArgs(service.scope), '--no-ask-password', '--no-block', 'restart', '--', service.unit,
106
+ ], { encoding: 'utf8', timeout: 5_000, maxBuffer: 64 * 1024 });
107
+ updateRestartRequest(file, requestId, { status: 'accepted' });
108
+ }
109
+ catch (error) {
110
+ const reason = error instanceof Error ? error.message : String(error);
111
+ // A timeout can happen after the job was enqueued. Keep the durable
112
+ // binding so a replacement can still prove ready; forbid another restart.
113
+ const uncertain = error.killed === true;
114
+ updateRestartRequest(file, requestId, { ...(uncertain ? {} : { status: 'failed' }), reason });
115
+ throw error;
116
+ }
117
+ });
118
+ }
119
+ /** Called only after this daemon has written its own ready signal. */
120
+ export async function completeSystemdRestart(file) {
121
+ const pending = readRestartRequest(file);
122
+ if (pending?.backend !== 'systemd' || !pending.systemd
123
+ || !['requested', 'accepted'].includes(pending.status))
124
+ return false;
125
+ return withFileLock(`${file}.systemd.lock`, async () => {
126
+ const request = readRestartRequest(file, pending.requestId);
127
+ if (!request?.systemd || !['requested', 'accepted'].includes(request.status))
128
+ return false;
129
+ if (!await resumeSystemdRestart(file))
130
+ return false;
131
+ const startedAt = getProcessStartTime(process.pid, { fresh: true });
132
+ if (!startedAt)
133
+ return false;
134
+ return updateRestartRequest(file, request.requestId, {
135
+ status: 'ready', daemonPid: process.pid, daemonStartedAt: startedAt,
136
+ });
137
+ });
138
+ }
139
+ /** The foreground launcher must preserve pure-restart intent on the new invocation. */
140
+ export async function resumeSystemdRestart(file) {
141
+ const request = readRestartRequest(file);
142
+ if (request?.backend !== 'systemd' || !request.systemd
143
+ || !['requested', 'accepted'].includes(request.status))
144
+ return null;
145
+ const startedAt = getProcessStartTime(process.pid, { fresh: true });
146
+ if (!startedAt || startedAt <= request.systemd.daemonStartedAt)
147
+ return null;
148
+ const service = await discoverSystemdService(process.pid, startedAt);
149
+ if (!service || service.unit !== request.systemd.unit || service.scope !== request.systemd.scope
150
+ || service.controlGroup !== request.systemd.controlGroup
151
+ || service.invocationId === request.systemd.invocationId)
152
+ return null;
153
+ return request;
154
+ }
@@ -11,8 +11,9 @@ import fs from 'fs';
11
11
  import path from 'path';
12
12
  import { createHash } from 'crypto';
13
13
  import { parseDocument } from 'yaml';
14
- import { agentWelcomePath, channelStatePath, resolveRoot } from '../paths.js';
14
+ import { agentMdPath, agentWelcomePath, channelStatePath, resolveRoot } from '../paths.js';
15
15
  import { isValidAid } from '../aun/aid/validation.js';
16
+ import { parseAgentDisplayName, resolveAgentDisplayName } from '../aun/aid/agentmd.js';
16
17
  import { loadAgent, saveAgent } from '../config-store.js';
17
18
  import { resolveAgentLifecycle, withLifecycleForWrite } from '../config/lifecycle.js';
18
19
  import { renderTemplate } from '../eck/manifest-engine.js';
@@ -179,34 +180,59 @@ export function parseAgentWelcomeMetadata(content) {
179
180
  // ============================================================================
180
181
  // 欢迎消息生成
181
182
  // ============================================================================
183
+ /** 句末装饰性标点:这些只是收尾习惯,不承载语气,可以换成统一的句号。 */
184
+ const TRAILING_DECORATIVE_MARKS = /([。..…~~]+)([”’"))】」』]*)$/;
185
+ /** 问号、感叹号是语义标点,保留原样,后面不再补句号。 */
186
+ const ENDS_WITH_EXPRESSIVE_MARK = /[!!??][”’"))】」』]*$/;
182
187
  /**
183
- * 生成统一的欢迎消息文本
188
+ * 把名片 description 规整成可以嵌入句子的短语。
189
+ *
190
+ * description 是自由文本,默认值 `EvolCore AI agent.` 本身带英文句点;直接拼在
191
+ * `我是X,` 后面再补一个中文句号,就会输出 `.。` 这种连排标点。这里只剥掉句末的
192
+ * 装饰性标点,正文一字不动——冒号、顿号、括号等句中标点都不属于句末。
193
+ */
194
+ export function normalizeAgentDescription(value) {
195
+ const text = value?.trim();
196
+ if (!text)
197
+ return '';
198
+ const match = text.match(TRAILING_DECORATIVE_MARKS);
199
+ if (!match)
200
+ return text;
201
+ const body = text.slice(0, match.index).trimEnd();
202
+ // 只有标点、没有正文,等于没写 description。
203
+ return body ? `${body}${match[2]}` : '';
204
+ }
205
+ /** 把 description 作为一句独立陈述收尾;语气标点原样保留。 */
206
+ function endSentence(value) {
207
+ const description = normalizeAgentDescription(value);
208
+ if (!description)
209
+ return '';
210
+ return ENDS_WITH_EXPRESSIVE_MARK.test(description) ? description : `${description}。`;
211
+ }
212
+ /**
213
+ * 生成默认欢迎消息文本
214
+ *
215
+ * 这是 `--initialize` 一次性初始化、以及存量 Agent 的兜底文案。职责取自名片
216
+ * description,不写死能力清单:每个 Agent 的职责差别很大,通用清单只会说出一堆
217
+ * 它其实不干的事。交互式 Bootstrap 有自己的 `personal/welcome.md`,不走这里。
184
218
  */
185
219
  export function generateWelcomeMessage(options) {
186
220
  const greeting = options.ownerName
187
221
  ? `👋 你好,${options.ownerName}!`
188
222
  : '👋 你好!';
189
- const agentIntro = options.agentName
190
- ? `我是 ${options.agentName},很高兴认识你。`
191
- : '我是你的 AI 助手,很高兴认识你。';
223
+ const identity = options.agentName || '你的助手';
224
+ const description = endSentence(options.agentDescription);
225
+ const intro = description
226
+ ? `我是${identity},${description}`
227
+ : `我是${identity}。`;
192
228
  const channelSpecificNote = getChannelSpecificNote(options.channelType);
193
- // Owner 才会收到:说明可以随时通过对话调整 Agent 的设定
194
- const ownerNote = options.includeBindingNote
195
- ? '\n\n🎨 我的名字、性格和说话风格都可以由你来定,想调整时直接告诉我。'
196
- : '';
197
229
  return `${greeting}
198
230
 
199
- ${agentIntro}有什么需要,直接用平常说话的方式告诉我就行,不用记任何指令。
231
+ ${intro}
200
232
 
201
- 我可以帮你:
202
- - 💬 解答问题、出主意、一起梳理思路
203
- - 📝 写文案、改文档、整理总结
204
- - ⏰ 定时提醒、到点跟进事情
205
- - 🧠 记住你的习惯和偏好,下次不用重复交代${channelSpecificNote}${ownerNote}
233
+ 有什么需要,直接用平常说话的方式告诉我就行,不用记任何指令。${channelSpecificNote}
206
234
 
207
- 想看更多玩法,随时发送 /help。
208
-
209
- 那我们从哪儿开始?`;
235
+ 有事随时找我。`;
210
236
  }
211
237
  export function renderPostBootstrapWelcomeMessage(options) {
212
238
  const validation = validateWelcomeTemplate(options.template);
@@ -223,7 +249,8 @@ export function renderPostBootstrapWelcomeMessage(options) {
223
249
  };
224
250
  const rendered = renderTemplate(options.template, {
225
251
  agentName: literal(options.agentName),
226
- agentDescription: literal(options.agentDescription),
252
+ // 模板普遍写成 `{{agentDescription}}。`,description 自带句末标点时同样会连排。
253
+ agentDescription: literal(normalizeAgentDescription(options.agentDescription)),
227
254
  agentAid: literal(options.agentAid),
228
255
  agentTags: (options.agentTags ?? []).map(literal),
229
256
  agentTagsText: literal((options.agentTags ?? []).join(', ')),
@@ -366,12 +393,29 @@ export class FirstInteractionWelcomeManager {
366
393
  }
367
394
  /**
368
395
  * 生成欢迎消息文本
396
+ *
397
+ * 名字和职责都以本地名片为准;名片不可用时才退回 AID 前缀,避免把
398
+ * `phonecall` 这类内部标识直接说给用户听。
369
399
  */
370
400
  generateWelcomeText() {
371
- const agentName = this.agentAid.split('.')[0];
401
+ const mdPath = agentMdPath(this.agentAid);
402
+ let agentMd = '';
403
+ try {
404
+ if (fs.existsSync(mdPath))
405
+ agentMd = fs.readFileSync(mdPath, 'utf-8');
406
+ }
407
+ catch (e) {
408
+ logger.warn(`[WelcomeManager] Failed to read agent.md for ${this.agentAid}: ${e}`);
409
+ }
410
+ const metadata = parseAgentWelcomeMetadata(agentMd);
411
+ const agentName = metadata.name
412
+ || parseAgentDisplayName(agentMd)
413
+ || resolveAgentDisplayName(this.agentAid)
414
+ || this.agentAid.split('.')[0];
372
415
  return generateWelcomeMessage({
373
416
  channelType: this.channelType,
374
417
  agentName,
418
+ agentDescription: metadata.description,
375
419
  });
376
420
  }
377
421
  /**
@@ -246,16 +246,20 @@ function cacheKey(filePath) {
246
246
  * the existing parser behavior; only Windows enters the Authenticode path.
247
247
  */
248
248
  export function isTrustedWindowsShellExecutable(executable, kind) {
249
- if (process.platform !== 'win32')
250
- return true;
251
249
  try {
252
- verifyWindowsShellExecutable(executable, kind);
250
+ requireTrustedWindowsShellExecutable(executable, kind);
253
251
  return true;
254
252
  }
255
253
  catch {
256
254
  return false;
257
255
  }
258
256
  }
257
+ /** Preserve the concrete failure for EC permission checks and CLI diagnostics. */
258
+ export function requireTrustedWindowsShellExecutable(executable, kind) {
259
+ if (process.platform !== 'win32')
260
+ return executable;
261
+ return verifyWindowsShellExecutable(executable, kind);
262
+ }
259
263
  function verifyWindowsShellExecutable(executable, kind) {
260
264
  const resolved = resolveShellPath(executable, kind);
261
265
  if (!resolved) {
package/ecagent/README.md CHANGED
@@ -54,12 +54,47 @@ Execution settles only after the supervisor exits, not when cancellation is
54
54
  merely requested. Both output streams are forwarded as UTF-8 bytes; internal
55
55
  completion markers are removed before tool results and streaming callbacks.
56
56
 
57
+ The returned stdout and stderr each retain at most 64 KiB of recent UTF-8 output,
58
+ with an explicit truncation marker. Streaming callbacks still receive the full
59
+ stream. `inheritEnv: false` lets a Host supply an environment allowlist, and the
60
+ optional `prepareShell` callback lets it wrap execution in its existing sandbox.
61
+
62
+ EvolCore uses those hooks for its task environment and filesystem policy. Scoped
63
+ Linux execution uses the existing bubblewrap backend; scoped Windows execution
64
+ uses the provisioned Codex filesystem backend and verifies explicit read denial
65
+ in a descendant. These backends live in the shared Host permission module
66
+ (`src/core/permission/sandbox-runtime.ts`), without importing Trigger or another
67
+ Runner. Windows still requires the installed, provisioned Codex CLI sandbox.
68
+ Network access remains enabled. Owner bypass and trusted
69
+ fullaccess follow the existing Host policy; scoped execution fails if its
70
+ required filesystem backend is unavailable. The Windows wrapper has fixture
71
+ coverage and still needs native Windows acceptance.
72
+
57
73
  A command that completes normally can leave an intentionally backgrounded
58
74
  service alive if that service redirects its output. While an execution is still
59
75
  pending, interruption terminates all processes in its job. Long-running managed
60
76
  services should use EvolCore's service manager rather than rely on an open Bash
61
77
  tool call. The supervisor fails closed if job assignment is unavailable.
62
78
 
79
+ ## Tool and model-response boundaries
80
+
81
+ Read-only tool batches use at most eight concurrent workers and retain the
82
+ original result order. Batches containing sequential tools remain sequential.
83
+ The Host's preflight may replace tool arguments; the harness validates the
84
+ replacement before executing it. EvolCore routes every built-in tool through
85
+ one Host execution/result-validation wrapper, including Skills and questions.
86
+
87
+ An output-length termination settles all tool calls in that response as failed
88
+ without executing them and ends the turn. The optional `reportedUsage` field
89
+ distinguishes omitted usage from reported zeros; EvolCore's statistics use only
90
+ reported fields.
91
+
92
+ On HTTP 413, EvolCore can omit older images from the model request and retry that
93
+ model step once, retaining the newest image. It persists the omission before
94
+ retrying, preserves the original session history, and restores the omission on
95
+ resume. With one image, or if the reduced request is still too large, it reports
96
+ `request_too_large` without replaying tools.
97
+
63
98
  ## Automatic context compaction
64
99
 
65
100
  `AgentHarness` accepts an optional `autoCompactWindow` token threshold. When set
@@ -2,7 +2,7 @@
2
2
  * Agent loop that works with AgentMessage throughout.
3
3
  * Transforms to Message[] only at the LLM call boundary.
4
4
  */
5
- import { EventStream, streamSimple, validateToolArguments, } from "./runtime/compat.js";
5
+ import { EventStream, streamSimple, completeToolResults, validateToolArguments, } from "./runtime/compat.js";
6
6
  /**
7
7
  * Start an agent loop with a new prompt message.
8
8
  * The prompt is added to the context and events are emitted for it.
@@ -158,6 +158,10 @@ async function runLoop(initialContext, newMessages, initialConfig, signal, emit,
158
158
  }
159
159
  }
160
160
  await emit({ type: "turn_end", message, toolResults });
161
+ if (message.stopReason === "length") {
162
+ await emit({ type: "agent_end", messages: newMessages });
163
+ return;
164
+ }
161
165
  if (signal?.aborted) {
162
166
  await finishAbortedRun();
163
167
  return;
@@ -221,7 +225,7 @@ async function streamAssistantResponse(context, config, signal, emit, streamFn)
221
225
  messages = await config.transformContext(messages, signal);
222
226
  }
223
227
  // Convert to LLM-compatible messages (AgentMessage[] → Message[])
224
- const llmMessages = await config.convertToLlm(messages);
228
+ const llmMessages = completeToolResults(await config.convertToLlm(messages));
225
229
  // Build LLM context
226
230
  const llmContext = {
227
231
  systemPrompt: context.systemPrompt,
@@ -362,10 +366,8 @@ async function executeToolCallsSequential(currentContext, assistantMessage, tool
362
366
  await emitToolResultMessage(toolResultMessage, emit);
363
367
  finalizedCalls.push(finalized);
364
368
  messages.push(toolResultMessage);
365
- if (signal?.aborted) {
366
- break;
367
- }
368
369
  }
370
+ messages.push(...await answerPendingToolCalls(toolCalls, finalizedCalls, signal, emit));
369
371
  return {
370
372
  messages,
371
373
  terminate: shouldTerminateToolBatch(finalizedCalls),
@@ -374,48 +376,88 @@ async function executeToolCallsSequential(currentContext, assistantMessage, tool
374
376
  async function executeToolCallsParallel(currentContext, assistantMessage, toolCalls, config, signal, emit) {
375
377
  const finalizedCalls = [];
376
378
  for (const toolCall of toolCalls) {
377
- await emit({
378
- type: "tool_execution_start",
379
- toolCallId: toolCall.id,
380
- toolName: toolCall.name,
381
- args: toolCall.arguments,
382
- });
383
- const preparation = await prepareToolCall(currentContext, assistantMessage, toolCall, config, signal);
384
- if (preparation.kind === "immediate") {
385
- const finalized = {
386
- toolCall,
387
- result: preparation.result,
388
- isError: preparation.isError,
389
- };
390
- await emitToolExecutionEnd(finalized, emit);
391
- finalizedCalls.push(finalized);
392
- if (signal?.aborted) {
393
- break;
394
- }
395
- continue;
396
- }
397
379
  finalizedCalls.push(async () => {
380
+ await emit({
381
+ type: "tool_execution_start",
382
+ toolCallId: toolCall.id,
383
+ toolName: toolCall.name,
384
+ args: toolCall.arguments,
385
+ });
386
+ const preparation = await prepareToolCall(currentContext, assistantMessage, toolCall, config, signal);
387
+ if (preparation.kind === "immediate") {
388
+ const finalized = {
389
+ toolCall,
390
+ result: preparation.result,
391
+ isError: preparation.isError,
392
+ };
393
+ await emitToolExecutionEnd(finalized, emit);
394
+ return finalized;
395
+ }
398
396
  const executed = await executePreparedToolCall(preparation, signal, emit);
399
397
  const finalized = await finalizeExecutedToolCall(currentContext, assistantMessage, preparation, executed, config, signal);
400
398
  await emitToolExecutionEnd(finalized, emit);
401
399
  return finalized;
402
400
  });
403
- if (signal?.aborted) {
404
- break;
405
- }
406
401
  }
407
- const orderedFinalizedCalls = await Promise.all(finalizedCalls.map((entry) => (typeof entry === "function" ? entry() : Promise.resolve(entry))));
402
+ // Keep read-only batches bounded without changing result ordering. Each
403
+ // worker settles its call before taking another; writes use the serial path.
404
+ const orderedFinalizedCalls = new Array(finalizedCalls.length);
405
+ let nextIndex = 0;
406
+ await Promise.all(Array.from({ length: Math.min(8, finalizedCalls.length) }, async () => {
407
+ while (nextIndex < finalizedCalls.length) {
408
+ const index = nextIndex++;
409
+ const entry = finalizedCalls[index];
410
+ orderedFinalizedCalls[index] = typeof entry === "function" ? await entry() : entry;
411
+ }
412
+ }));
408
413
  const messages = [];
409
414
  for (const finalized of orderedFinalizedCalls) {
410
415
  const toolResultMessage = createToolResultMessage(finalized);
411
416
  await emitToolResultMessage(toolResultMessage, emit);
412
417
  messages.push(toolResultMessage);
413
418
  }
419
+ messages.push(...await answerPendingToolCalls(toolCalls, orderedFinalizedCalls, signal, emit));
414
420
  return {
415
421
  messages,
416
422
  terminate: shouldTerminateToolBatch(orderedFinalizedCalls),
417
423
  };
418
424
  }
425
+ /**
426
+ * Answer every tool call the batch did not get to.
427
+ *
428
+ * Cancellation stops the batch early, so calls queued behind the one that was
429
+ * running never produce a result. The assistant message that requested them is
430
+ * still persisted (its stopReason is `toolUse`, not `error`/`aborted`), which
431
+ * leaves the session history with a `tool_calls` entry no tool message answers —
432
+ * OpenAI-compatible gateways reject that shape with HTTP 400 on every later
433
+ * request, permanently wedging the session.
434
+ */
435
+ async function answerPendingToolCalls(toolCalls, answered, signal, emit) {
436
+ const answeredIds = new Set(answered.map((finalized) => finalized.toolCall.id));
437
+ const messages = [];
438
+ for (const toolCall of toolCalls) {
439
+ if (answeredIds.has(toolCall.id))
440
+ continue;
441
+ const finalized = {
442
+ toolCall,
443
+ result: createRejectedToolResult(undefined, signal),
444
+ isError: true,
445
+ };
446
+ // These calls never started, so the start event is emitted here to keep
447
+ // the renderer's start/end pairing intact.
448
+ await emit({
449
+ type: "tool_execution_start",
450
+ toolCallId: toolCall.id,
451
+ toolName: toolCall.name,
452
+ args: toolCall.arguments,
453
+ });
454
+ await emitToolExecutionEnd(finalized, emit);
455
+ const toolResultMessage = createToolResultMessage(finalized);
456
+ await emitToolResultMessage(toolResultMessage, emit);
457
+ messages.push(toolResultMessage);
458
+ }
459
+ return messages;
460
+ }
419
461
  function shouldTerminateToolBatch(finalizedCalls) {
420
462
  return finalizedCalls.length > 0 && finalizedCalls.every((finalized) => finalized.result.terminate === true);
421
463
  }
@@ -433,6 +475,11 @@ function prepareToolCallArguments(tool, toolCall) {
433
475
  };
434
476
  }
435
477
  async function prepareToolCall(currentContext, assistantMessage, toolCall, config, signal) {
478
+ // Every declared call needs a result, including those not started when the
479
+ // batch was interrupted. Do not validate or invoke permission hooks again.
480
+ if (signal?.aborted) {
481
+ return { kind: "immediate", result: createRejectedToolResult(undefined, signal), isError: true };
482
+ }
436
483
  const tool = currentContext.tools?.find((t) => t.name === toolCall.name);
437
484
  if (!tool) {
438
485
  return {
@@ -443,7 +490,7 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
443
490
  }
444
491
  try {
445
492
  const preparedToolCall = prepareToolCallArguments(tool, toolCall);
446
- const validatedArgs = validateToolArguments(tool, preparedToolCall);
493
+ let validatedArgs = validateToolArguments(tool, preparedToolCall);
447
494
  if (config.beforeToolCall) {
448
495
  const beforeResult = await config.beforeToolCall({
449
496
  assistantMessage,
@@ -458,6 +505,9 @@ async function prepareToolCall(currentContext, assistantMessage, toolCall, confi
458
505
  isError: true,
459
506
  };
460
507
  }
508
+ if (beforeResult?.input) {
509
+ validatedArgs = validateToolArguments(tool, { ...toolCall, arguments: beforeResult.input });
510
+ }
461
511
  }
462
512
  if (signal?.aborted) {
463
513
  return {
@@ -1,12 +1,27 @@
1
1
  import { type ExecutionEnv, ExecutionError, FileError, type FileInfo, type Result } from "../types.ts";
2
+ type PrepareShell = (launch: {
3
+ command: string;
4
+ args: string[];
5
+ cwd: string;
6
+ env: NodeJS.ProcessEnv;
7
+ signal?: AbortSignal;
8
+ }) => Promise<{
9
+ command: string;
10
+ args: string[];
11
+ env?: NodeJS.ProcessEnv;
12
+ }>;
2
13
  export declare class NodeExecutionEnv implements ExecutionEnv {
3
14
  cwd: string;
4
15
  private shellPath?;
5
16
  private shellEnv?;
17
+ private inheritEnv;
18
+ private prepareShell?;
6
19
  constructor(options: {
7
20
  cwd: string;
8
21
  shellPath?: string;
9
22
  shellEnv?: NodeJS.ProcessEnv;
23
+ inheritEnv?: boolean;
24
+ prepareShell?: PrepareShell;
10
25
  });
11
26
  absolutePath(path: string): Promise<Result<string, FileError>>;
12
27
  joinPath(parts: string[]): Promise<Result<string, FileError>>;
@@ -48,4 +63,5 @@ export declare class NodeExecutionEnv implements ExecutionEnv {
48
63
  }): Promise<Result<string, FileError>>;
49
64
  cleanup(): Promise<void>;
50
65
  }
66
+ export {};
51
67
  //# sourceMappingURL=nodejs.d.ts.map