evolcore 0.0.50 → 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 (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,132 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { randomUUID } from 'node:crypto';
4
+ import { agentDir } from '../../paths.js';
5
+ import { remoteAssert, assertAbilityPath } from './command.js';
6
+ import { isJsonObject } from '../interop-v1.js';
7
+ const MAX_CREDENTIAL_BYTES = 128 * 1024;
8
+ export function credentialTargetsFromParams(params) {
9
+ if (!Array.isArray(params.items))
10
+ return [];
11
+ const targets = [];
12
+ for (const value of params.items) {
13
+ if (!isJsonObject(value) || typeof value.item_id !== 'string' || !isJsonObject(value.target))
14
+ continue;
15
+ const target = value.target;
16
+ if ([target.resource_aid, target.ability_path, target.definition_id, target.device_id].some(item => typeof item !== 'string'))
17
+ continue;
18
+ try {
19
+ assertAbilityPath(target.ability_path);
20
+ if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(target.definition_id))
21
+ continue;
22
+ targets.push({ itemId: value.item_id, resourceAid: target.resource_aid, abilityPath: target.ability_path,
23
+ definitionId: target.definition_id, deviceId: target.device_id });
24
+ }
25
+ catch { /* Invalid targets are ignored; Provider remains the authority. */ }
26
+ }
27
+ return targets;
28
+ }
29
+ export function approvedCredentialTargets(result, targets, applicationId) {
30
+ let approvedItems = result.approved_items;
31
+ if (!Array.isArray(approvedItems) && Array.isArray(result.applications)) {
32
+ const application = result.applications.find(item => isJsonObject(item)
33
+ && (applicationId === undefined || item.application_id === applicationId));
34
+ if (isJsonObject(application))
35
+ approvedItems = application.approved_items;
36
+ }
37
+ if (!Array.isArray(approvedItems))
38
+ return undefined;
39
+ const requested = new Map(targets.map(target => [target.itemId, target]));
40
+ const seen = new Set();
41
+ return approvedItems.filter(isJsonObject).flatMap(item => {
42
+ if (typeof item.item_id !== 'string' || seen.has(item.item_id) || item.revoked === true
43
+ || !Array.isArray(item.approved_scopes) || !item.approved_scopes.length)
44
+ return [];
45
+ seen.add(item.item_id);
46
+ const target = isJsonObject(item.target) ? item.target : undefined;
47
+ if (target && typeof target.resource_aid === 'string' && typeof target.device_id === 'string'
48
+ && typeof target.ability_path === 'string' && typeof target.definition_id === 'string') {
49
+ try {
50
+ assertAbilityPath(target.ability_path);
51
+ if (!/^[a-z0-9][a-z0-9_-]{0,63}$/.test(target.definition_id))
52
+ return [];
53
+ return [{ itemId: item.item_id, resourceAid: target.resource_aid, deviceId: target.device_id,
54
+ abilityPath: target.ability_path, definitionId: target.definition_id }];
55
+ }
56
+ catch {
57
+ return [];
58
+ }
59
+ }
60
+ const fallback = requested.get(item.item_id);
61
+ return fallback ? [fallback] : [];
62
+ });
63
+ }
64
+ function segment(value) {
65
+ remoteAssert(value.length > 0 && value.length <= 512 && !/[\0\r\n]/.test(value), 'CREDENTIAL_INVALID', 'Invalid credential path component');
66
+ // encodeURIComponent leaves dots untouched, including traversal segments.
67
+ return encodeURIComponent(value).replace(/\./g, '%2E');
68
+ }
69
+ function ensureDirectory(directory, privateDirectory = true) {
70
+ fs.mkdirSync(directory, { recursive: true, mode: 0o700 });
71
+ const stat = fs.lstatSync(directory);
72
+ remoteAssert(stat.isDirectory() && !stat.isSymbolicLink(), 'CREDENTIAL_PATH_INVALID', 'Credential directory must not be a symbolic link');
73
+ if (privateDirectory && process.platform !== 'win32')
74
+ fs.chmodSync(directory, 0o700);
75
+ }
76
+ export function credentialFilePath(selfAid, providerAid, target) {
77
+ assertAbilityPath(target.abilityPath);
78
+ remoteAssert(/^[a-z0-9][a-z0-9_-]{0,63}$/.test(target.definitionId), 'CREDENTIAL_INVALID', 'Invalid credential definition ID');
79
+ const root = agentDir(selfAid);
80
+ const directory = path.join(root, 'credentials', segment(providerAid), segment(target.resourceAid), target.abilityPath.split('/').map(segment).join(path.sep), segment(target.definitionId), segment(target.deviceId));
81
+ const file = path.join(directory, 'credential.json');
82
+ remoteAssert(path.relative(path.join(root, 'credentials'), file).split(path.sep)[0] !== '..', 'CREDENTIAL_PATH_INVALID', 'Credential path escaped the Agent directory');
83
+ return file;
84
+ }
85
+ export function saveCredentialForTarget(selfAid, providerAid, target, credential) {
86
+ remoteAssert(isJsonObject(credential) && Object.keys(credential).length > 0, 'CREDENTIAL_INVALID', 'Expected a complete credential object');
87
+ const bytes = Buffer.from(`${JSON.stringify(credential, null, 2)}\n`, 'utf8');
88
+ remoteAssert(bytes.length <= MAX_CREDENTIAL_BYTES, 'CREDENTIAL_INVALID', 'Credential exceeds size limit');
89
+ const file = credentialFilePath(selfAid, providerAid, target);
90
+ const root = agentDir(selfAid);
91
+ const credentialsRoot = path.join(root, 'credentials');
92
+ const parent = path.dirname(file);
93
+ ensureDirectory(root, false);
94
+ ensureDirectory(credentialsRoot);
95
+ const relative = path.relative(credentialsRoot, parent);
96
+ let current = credentialsRoot;
97
+ for (const part of relative.split(path.sep).filter(Boolean)) {
98
+ current = path.join(current, part);
99
+ ensureDirectory(current);
100
+ }
101
+ if (fs.existsSync(file)) {
102
+ const existingStat = fs.lstatSync(file);
103
+ remoteAssert(existingStat.isFile() && !existingStat.isSymbolicLink() && existingStat.nlink === 1, 'CREDENTIAL_PATH_INVALID', 'Existing credential file must be a private regular file');
104
+ }
105
+ const temporary = path.join(parent, `.credential-${randomUUID()}.tmp`);
106
+ const noFollow = fs.constants.O_NOFOLLOW ?? 0;
107
+ const descriptor = fs.openSync(temporary, fs.constants.O_WRONLY | fs.constants.O_CREAT | fs.constants.O_EXCL | noFollow, 0o600);
108
+ try {
109
+ fs.writeFileSync(descriptor, bytes);
110
+ fs.fsyncSync(descriptor);
111
+ }
112
+ catch (error) {
113
+ fs.unlinkSync(temporary);
114
+ throw error;
115
+ }
116
+ finally {
117
+ fs.closeSync(descriptor);
118
+ }
119
+ try {
120
+ fs.renameSync(temporary, file);
121
+ }
122
+ finally {
123
+ try {
124
+ fs.unlinkSync(temporary);
125
+ }
126
+ catch { /* rename consumed the temporary file */ }
127
+ }
128
+ const stat = fs.lstatSync(file);
129
+ remoteAssert(stat.isFile() && !stat.isSymbolicLink() && stat.nlink === 1
130
+ && (process.platform === 'win32' || (stat.mode & 0o077) === 0), 'CREDENTIAL_PATH_INVALID', 'Credential file must be private and unlinked');
131
+ return file;
132
+ }
@@ -5,8 +5,10 @@ import { parseRemoteCommand, remoteOperation, remoteAssert, RemoteError } from '
5
5
  import { boundedJson, sameProviderPath } from './contract.js';
6
6
  import { isJsonObject } from '../interop-v1.js';
7
7
  import { createRemoteAbilityAuthorizer } from './authorization.js';
8
+ import { hashDelegatedCommandArgv, parseDelegatedExecutionSpec } from '../../core/auth/agent-delegation.js';
9
+ import { MAIN_CLI_BIN } from '../../product.js';
8
10
  import { sessionTopicThreadId } from '../../core/thread/topic-id.js';
9
- import { readTriggerLocalFile } from '../../trigger/local-files.js';
11
+ import { readManagedLocalFile } from '../../core/permission/managed-file.js';
10
12
  import { readPersonalFsBytesWithinBudget } from '../../aun/group/fs-download.js';
11
13
  import { getAunRequestRegistry } from '../../core/message/aun-request-registry.js';
12
14
  export function createRemoteAbilityExecutor(root, deps, channels) {
@@ -19,13 +21,19 @@ export function createRemoteAbilityExecutor(root, deps, channels) {
19
21
  let mayHaveSent = false;
20
22
  try {
21
23
  remoteAssert(input.type === 'ability.remote.op' && input.sessionId && input.delegationToken && input.delegationCommandHash, 'DELEGATION_REQUIRED', 'Remote Ability requires an approved AUN managed command');
22
- const command = parseRemoteCommand(input.argv);
24
+ const argv = [...input.argv];
25
+ const command = parseRemoteCommand(argv);
26
+ const executionSpec = input.executionSpec === undefined ? undefined : parseDelegatedExecutionSpec(input.executionSpec);
23
27
  // Never accept the in-process delegationGrant/targetAid continuation
24
28
  // fields from an IPC body.
25
29
  const credentials = { sessionId: String(input.sessionId), delegationToken: String(input.delegationToken), delegationCommandHash: String(input.delegationCommandHash) };
26
30
  stage = 'authorization';
31
+ remoteAssert(input.executionSpec === undefined || executionSpec, 'INVALID_DELEGATION', 'Invalid Ability execution spec');
27
32
  const permitted = await authorize(credentials, remoteOperation(command));
28
33
  remoteAssert(permitted.ok, permitted.ok ? '' : permitted.code, permitted.ok ? '' : permitted.error);
34
+ // Bind the actual Ability argv to the same immutable wrapper snapshot
35
+ // used by IPC/preflight, before any remote reads or asynchronous sends.
36
+ remoteAssert(hashDelegatedCommandArgv([MAIN_CLI_BIN, ...argv], executionSpec) === credentials.delegationCommandHash, 'INVALID_DELEGATION', 'Ability command hash mismatch');
29
37
  const grant = permitted.grant;
30
38
  stage = 'session';
31
39
  remoteAssert(grant.channelType === 'aun', 'AUN_SESSION_REQUIRED', 'Remote Ability requires an AUN managed session');
@@ -42,9 +50,9 @@ export function createRemoteAbilityExecutor(root, deps, channels) {
42
50
  let params = {};
43
51
  stage = 'input';
44
52
  const raw = command.options['params-file']
45
- ? new TextDecoder('utf-8', { fatal: true }).decode(readTriggerLocalFile(command.options['params-file'], {
53
+ ? new TextDecoder('utf-8', { fatal: true }).decode(readManagedLocalFile(command.options['params-file'], {
46
54
  selfAid: grant.selfAid, projectPath: session.projectPath, sessionRuntimeDir: grant.sessionRuntimeDir, cwd: session.projectPath,
47
- })) : command.options.params;
55
+ }, 'message')) : command.options.params;
48
56
  if (raw !== undefined) {
49
57
  remoteAssert(Buffer.byteLength(raw) <= 1024 * 1024, 'INPUT_TOO_LARGE', 'Params exceed 1 MiB');
50
58
  try {
@@ -56,6 +64,23 @@ export function createRemoteAbilityExecutor(root, deps, channels) {
56
64
  remoteAssert(isJsonObject(params), 'PARAMS_INVALID', 'Params must be a JSON object');
57
65
  boundedJson(params, 1024 * 1024);
58
66
  }
67
+ let credential;
68
+ if (command.options['credential-file']) {
69
+ const bytes = readManagedLocalFile(command.options['credential-file'], {
70
+ selfAid: grant.selfAid, projectPath: session.projectPath, sessionRuntimeDir: grant.sessionRuntimeDir, cwd: session.projectPath,
71
+ }, 'credential');
72
+ remoteAssert(bytes.length <= 128 * 1024, 'CREDENTIAL_INVALID', 'Credential exceeds size limit');
73
+ let value;
74
+ try {
75
+ value = JSON.parse(new TextDecoder('utf-8', { fatal: true }).decode(bytes));
76
+ }
77
+ catch {
78
+ throw new RemoteError('CREDENTIAL_INVALID', 'Credential file must contain a complete signed JSON object');
79
+ }
80
+ remoteAssert(isJsonObject(value) && Object.keys(value).length > 0, 'CREDENTIAL_INVALID', 'Credential file must contain a complete signed JSON object');
81
+ boundedJson(value);
82
+ credential = value;
83
+ }
59
84
  const fresh = async () => {
60
85
  remoteAssert(deps.agentDelegationRegistry.isCurrentTaskGrant(grant), 'INVALID_DELEGATION', 'Origin task was replaced or revoked');
61
86
  const permission = await authorize({ ...credentials, delegationGrant: grant }, remoteOperation(command));
@@ -117,9 +142,9 @@ export function createRemoteAbilityExecutor(root, deps, channels) {
117
142
  stage = 'send';
118
143
  mayHaveSent = true;
119
144
  return deps.ipcServer.sendAbilityRequest({
120
- aid: grant.selfAid, to: provider, payload, deviceId, timeoutMs, argv: input.argv,
145
+ aid: grant.selfAid, to: provider, payload, deviceId, timeoutMs, argv, executionSpec,
121
146
  originSessionId: grant.sessionId, originMessageId: grant.messageId,
122
- delegationToken: token, delegationCommandHash: input.delegationCommandHash,
147
+ delegationToken: token, delegationCommandHash: credentials.delegationCommandHash,
123
148
  }, grant);
124
149
  });
125
150
  },
@@ -141,7 +166,7 @@ export function createRemoteAbilityExecutor(root, deps, channels) {
141
166
  return record;
142
167
  },
143
168
  };
144
- const result = await service.execute(command, context, transport, params);
169
+ const result = await service.execute(command, context, transport, params, credential);
145
170
  if (callPermission && result.data)
146
171
  result.data.call_permission = callPermission.ok
147
172
  ? { allowed: true, scope: 'current-task', provider_authorization: 'checked_by_provider' }
@@ -0,0 +1,157 @@
1
+ import { canonicalizeAbilityJson, isJsonObject } from '../interop-v1.js';
2
+ import { RemoteError } from './command.js';
3
+ function actionField(schema) {
4
+ const field = isJsonObject(schema.properties) && schema.properties.action;
5
+ return isJsonObject(field) ? field : undefined;
6
+ }
7
+ function actionValues(field) {
8
+ if (typeof field?.const === 'string')
9
+ return [field.const];
10
+ return Array.isArray(field?.enum) && field.enum.every(value => typeof value === 'string') ? field.enum : [];
11
+ }
12
+ export function viewParamsSchema(schema, requested) {
13
+ const field = actionField(schema);
14
+ // A flat schema cannot express which optional fields belong to each action.
15
+ // Only discard alternatives when every branch declares an action constraint.
16
+ const branches = new Map();
17
+ const hasIndexedRefs = /"\$(?:ref|dynamicRef|recursiveRef)"/.test(JSON.stringify(schema));
18
+ for (const key of ['oneOf', 'anyOf']) {
19
+ const variants = schema[key];
20
+ if (!Array.isArray(variants) || !variants.length || !variants.every(isJsonObject))
21
+ continue;
22
+ // A published local ref may point to a branch by index. Preserve indices.
23
+ if (hasIndexedRefs)
24
+ continue;
25
+ const tagged = variants.map(variant => ({ schema: variant, actions: actionValues(actionField(variant)) }));
26
+ if (tagged.every(item => item.actions.length))
27
+ branches.set(key, tagged);
28
+ }
29
+ let values = actionValues(field);
30
+ for (const tagged of branches.values()) {
31
+ const branchValues = [...new Set(tagged.flatMap(item => item.actions))];
32
+ values = values.length ? values.filter(value => branchValues.includes(value)) : branchValues;
33
+ }
34
+ const action = requested ?? (values.length === 1 && Array.isArray(schema.required) && schema.required.includes('action') ? values[0] : undefined);
35
+ if (action === undefined)
36
+ return { schema: compactSchema(schema) };
37
+ if (!field && !branches.size && schema.additionalProperties === false) {
38
+ throw new RemoteError('ACTION_NOT_FOUND', 'The contract does not declare an action parameter');
39
+ }
40
+ if (values.length && !values.includes(action)) {
41
+ throw new RemoteError('ACTION_NOT_FOUND', 'Action is absent from the contract', { actions: values });
42
+ }
43
+ const properties = isJsonObject(schema.properties) ? schema.properties : {};
44
+ const required = Array.isArray(schema.required) ? schema.required : [];
45
+ const selected = { ...schema };
46
+ for (const [key, tagged] of branches) {
47
+ const matches = tagged.filter(item => item.actions.includes(action));
48
+ if (!matches.length)
49
+ throw new RemoteError('ACTION_NOT_FOUND', 'Action is absent from the contract', { actions: values });
50
+ selected[key] = matches.map(item => item.schema);
51
+ }
52
+ return { action, schema: compactSchema({
53
+ ...selected,
54
+ properties: { ...properties, action: { ...(Object.hasOwn(properties, 'action') ? field : { type: 'string' }), const: action } },
55
+ required: [...new Set([...required, 'action'])],
56
+ }) };
57
+ }
58
+ // Only replace whole schema nodes. Never rewrite example data or authored refs.
59
+ export function compactSchema(schema) {
60
+ const counts = new Map();
61
+ let hasRefs = false;
62
+ function children(node, visit) {
63
+ const out = { ...node };
64
+ for (const key of ['properties', 'patternProperties', 'dependentSchemas']) {
65
+ const map = node[key];
66
+ if (isJsonObject(map))
67
+ out[key] = Object.fromEntries(Object.entries(map)
68
+ .map(([name, val]) => [name, isJsonObject(val) ? visit(val, name) : val]));
69
+ }
70
+ for (const key of ['items', 'additionalProperties', 'contains', 'if', 'then', 'else', 'not']) {
71
+ const child = node[key];
72
+ if (isJsonObject(child))
73
+ out[key] = visit(child, key);
74
+ }
75
+ for (const key of ['anyOf', 'allOf', 'oneOf', 'prefixItems']) {
76
+ const list = node[key];
77
+ if (Array.isArray(list))
78
+ out[key] = list.map(child => isJsonObject(child) ? visit(child, key) : child);
79
+ }
80
+ return out;
81
+ }
82
+ function scan(node, name) {
83
+ if (['$ref', '$dynamicRef', '$recursiveRef', '$id', '$defs', 'definitions', '$anchor', '$dynamicAnchor', '$recursiveAnchor']
84
+ .some(key => Object.hasOwn(node, key)))
85
+ hasRefs = true;
86
+ const key = canonicalizeAbilityJson(node);
87
+ if (key.length >= 64) {
88
+ const known = counts.get(key);
89
+ if (known)
90
+ known.count++;
91
+ else
92
+ counts.set(key, { count: 1, name });
93
+ }
94
+ children(node, scan);
95
+ return node;
96
+ }
97
+ scan(schema, 'schema');
98
+ if (hasRefs)
99
+ return schema;
100
+ const definitions = Object.create(null);
101
+ const names = new Map();
102
+ function rewrite(node) {
103
+ const key = canonicalizeAbilityJson(node);
104
+ const entry = counts.get(key);
105
+ if (!entry || entry.count < 2)
106
+ return children(node, rewrite);
107
+ let name = names.get(key);
108
+ if (!name) {
109
+ const base = entry.name.replace(/[^\w-]/g, '_').slice(0, 40) || 'schema';
110
+ name = base;
111
+ for (let i = 2; Object.hasOwn(definitions, name); i++)
112
+ name = `${base}_${i}`;
113
+ names.set(key, name);
114
+ definitions[name] = null;
115
+ definitions[name] = children(node, rewrite);
116
+ }
117
+ return { $ref: `#/definitions/${name}` };
118
+ }
119
+ let view = children(schema, rewrite);
120
+ if (!Object.keys(definitions).length)
121
+ return schema;
122
+ // Counting before rewriting includes repeats inside a shared parent. Inline
123
+ // those definitions if the finished view only references them once.
124
+ for (;;) {
125
+ const uses = new Map();
126
+ const count = (node) => {
127
+ if (typeof node.$ref === 'string') {
128
+ const name = node.$ref.slice('#/definitions/'.length);
129
+ uses.set(name, (uses.get(name) ?? 0) + 1);
130
+ }
131
+ else
132
+ children(node, count);
133
+ return node;
134
+ };
135
+ count(view);
136
+ for (const def of Object.values(definitions))
137
+ if (isJsonObject(def))
138
+ count(def);
139
+ const inline = new Set(Object.keys(definitions).filter(name => (uses.get(name) ?? 0) <= 1));
140
+ if (!inline.size)
141
+ break;
142
+ const replace = (node) => {
143
+ const name = typeof node.$ref === 'string' && node.$ref.slice('#/definitions/'.length);
144
+ return name && inline.has(name) ? replace(definitions[name]) : children(node, replace);
145
+ };
146
+ view = replace(view);
147
+ for (const [name, def] of Object.entries(definitions))
148
+ if (!inline.has(name))
149
+ definitions[name] = replace(def);
150
+ for (const name of inline)
151
+ delete definitions[name];
152
+ }
153
+ if (!Object.keys(definitions).length)
154
+ return schema;
155
+ const compact = { ...view, definitions };
156
+ return JSON.stringify(compact).length < JSON.stringify(schema).length ? compact : schema;
157
+ }