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
@@ -1,4 +1,5 @@
1
1
  import { createHash } from 'node:crypto';
2
+ import Ajv from 'ajv';
2
3
  /** The wire profile currently implemented by EvolApp's ability host. */
3
4
  export const ABILITY_SPEC_VERSION = 'aid-ability/2';
4
5
  export const ABILITY_INDEX_SCHEMA = 'aun.ability.index.v1';
@@ -8,14 +9,17 @@ const PATH_RE = /^[a-z][a-z0-9_-]*(\/[a-z][a-z0-9_-]*)+$/;
8
9
  const DEFINITION_ID_RE = /^[a-z0-9][a-z0-9_-]{0,63}$/;
9
10
  const RELEASE_ID_RE = /^[a-f0-9]{64}$/;
10
11
  const SEMVER_RE = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/;
11
- // This is the same deliberately small schema profile checked by EvolApp's
12
- // `checkSchemaProfile`. Keeping the allow-list here prevents Core from
13
- // accepting a definition which the Flutter host would reject at registration.
14
- const SCHEMA_KEYWORDS = new Set([
12
+ const LOCAL_SCHEMA_KEYWORDS = new Set([
15
13
  'type', 'properties', 'required', 'additionalProperties', 'items', 'enum',
16
- 'const', 'minimum', 'maximum', 'minLength', 'maxLength', 'minItems',
17
- 'maxItems', 'description', 'default', 'untrusted_text',
14
+ 'const', 'minimum', 'maximum', 'minLength', 'maxLength', 'pattern',
15
+ 'minItems', 'maxItems', 'description', 'default', 'untrusted_text',
18
16
  ]);
17
+ // The schema profile Core can validate locally. It is enforced only when
18
+ // publishing a local plugin (`profile: 'strict'`). Reading a Provider's
19
+ // contract must never reject it for using a keyword this build doesn't know:
20
+ // the Provider owns its schema, and the caller has no vote over it.
21
+ const schemaValidator = new Ajv({ allErrors: true, strict: false, useDefaults: false, coerceTypes: false,
22
+ removeAdditional: false, addUsedSchema: false });
19
23
  const TRANSPORT_FIELDS = new Set([
20
24
  'device_id', 'slot_id', 'runtime_ref', 'target_runtime_ref',
21
25
  'sender_slot_id', 'to_device_id',
@@ -188,46 +192,95 @@ function validateEffects(value) {
188
192
  fail('duplicate effects', 'contract_invalid', 'effects');
189
193
  return effects;
190
194
  }
191
- function validateSchemaProfile(value, path = 'schema') {
195
+ function validateSchemaProfile(value, path = 'schema', profile = 'strict') {
192
196
  const schema = requiredRecord(value, path);
193
- const allowedTypes = new Set(['object', 'array', 'string', 'integer', 'boolean', 'null']);
194
- if (Object.keys(schema).some(key => !SCHEMA_KEYWORDS.has(key))) {
195
- fail('unsupported schema keyword', 'contract_invalid', path);
196
- }
197
- if (typeof schema.type !== 'string' || !allowedTypes.has(schema.type)) {
198
- fail('unsupported schema type', 'contract_invalid', `${path}.type`);
199
- }
200
- if (schema.additionalProperties !== undefined && typeof schema.additionalProperties !== 'boolean') {
201
- fail('additionalProperties must be boolean', 'contract_invalid', `${path}.additionalProperties`);
202
- }
203
- if (schema.properties !== undefined && !isJsonObject(schema.properties)) {
204
- fail('properties must be an object', 'contract_invalid', `${path}.properties`);
205
- }
206
- if (schema.required !== undefined && (!Array.isArray(schema.required)
207
- || schema.required.some(item => typeof item !== 'string'))) {
208
- fail('required must be an array of strings', 'contract_invalid', `${path}.required`);
209
- }
210
- for (const keyword of ['enum', 'required']) {
211
- if (schema[keyword] !== undefined && !Array.isArray(schema[keyword])) {
212
- fail(`${keyword} must be an array`, 'contract_invalid', `${path}.${keyword}`);
213
- }
214
- }
215
- for (const keyword of ['minimum', 'maximum', 'minLength', 'maxLength', 'minItems', 'maxItems']) {
216
- if (schema[keyword] !== undefined && (typeof schema[keyword] !== 'number' || !Number.isSafeInteger(schema[keyword]))) {
217
- fail(`${keyword} must be an integer`, 'contract_invalid', `${path}.${keyword}`);
197
+ try {
198
+ const inspect = (node, nodePath) => {
199
+ if (Array.isArray(node)) {
200
+ node.forEach((child, index) => inspect(child, `${nodePath}[${index}]`));
201
+ return;
202
+ }
203
+ if (!isJsonObject(node))
204
+ return;
205
+ if (profile === 'strict') {
206
+ if (Object.keys(node).some(key => !LOCAL_SCHEMA_KEYWORDS.has(key))) {
207
+ fail('unsupported schema keyword', 'contract_invalid', nodePath);
208
+ }
209
+ if (typeof node.type !== 'string' || !['object', 'array', 'string', 'integer', 'boolean', 'null'].includes(node.type)) {
210
+ fail('unsupported schema type', 'contract_invalid', `${nodePath}.type`);
211
+ }
212
+ if (node.additionalProperties !== undefined && typeof node.additionalProperties !== 'boolean') {
213
+ fail('additionalProperties must be boolean', 'contract_invalid', `${nodePath}.additionalProperties`);
214
+ }
215
+ if (node.properties !== undefined && !isJsonObject(node.properties))
216
+ fail('properties must be an object', 'contract_invalid', `${nodePath}.properties`);
217
+ if (node.required !== undefined && (!Array.isArray(node.required) || node.required.some(item => typeof item !== 'string'))) {
218
+ fail('required must be an array of strings', 'contract_invalid', `${nodePath}.required`);
219
+ }
220
+ for (const key of ['enum', 'required'])
221
+ if (node[key] !== undefined && !Array.isArray(node[key])) {
222
+ fail(`${key} must be an array`, 'contract_invalid', `${nodePath}.${key}`);
223
+ }
224
+ for (const key of ['minimum', 'maximum', 'minLength', 'maxLength', 'minItems', 'maxItems']) {
225
+ if (node[key] !== undefined && (typeof node[key] !== 'number' || !Number.isSafeInteger(node[key]))) {
226
+ fail(`${key} must be an integer`, 'contract_invalid', `${nodePath}.${key}`);
227
+ }
228
+ }
229
+ if (node.items !== undefined && !isJsonObject(node.items))
230
+ fail('items must be a schema object', 'contract_invalid', `${nodePath}.items`);
231
+ }
232
+ if (node.$schema !== undefined && node.$schema !== 'http://json-schema.org/draft-07/schema#') {
233
+ fail('Only JSON Schema Draft-07 is supported', 'contract_invalid', `${nodePath}.$schema`);
234
+ }
235
+ if (node.$ref !== undefined && (typeof node.$ref !== 'string' || !(node.$ref === '#' || node.$ref.startsWith('#/')))) {
236
+ fail('Only local JSON Schema references are supported', 'contract_invalid', `${nodePath}.$ref`);
237
+ }
238
+ if (profile === 'strict' && node.pattern !== undefined
239
+ && (node.type !== 'string' || typeof node.pattern !== 'string')) {
240
+ fail('pattern requires a string type', 'contract_invalid', `${nodePath}.pattern`);
241
+ }
242
+ if (typeof node.pattern === 'string') {
243
+ try {
244
+ new RegExp(node.pattern, 'u');
245
+ }
246
+ catch {
247
+ fail('invalid pattern', 'contract_invalid', `${nodePath}.pattern`);
248
+ }
249
+ }
250
+ for (const key of ['properties', 'patternProperties', 'definitions']) {
251
+ if (isJsonObject(node[key]))
252
+ for (const [name, child] of Object.entries(node[key]))
253
+ inspect(child, `${nodePath}.${key}.${name}`);
254
+ }
255
+ for (const key of ['items', 'additionalProperties', 'propertyNames', 'contains', 'not', 'if', 'then', 'else']) {
256
+ if (isJsonObject(node[key]) || Array.isArray(node[key]))
257
+ inspect(node[key], `${nodePath}.${key}`);
258
+ }
259
+ for (const key of ['allOf', 'anyOf', 'oneOf'])
260
+ if (Array.isArray(node[key]))
261
+ inspect(node[key], `${nodePath}.${key}`);
262
+ if (isJsonObject(node.dependencies))
263
+ for (const [name, child] of Object.entries(node.dependencies)) {
264
+ if (isJsonObject(child))
265
+ inspect(child, `${nodePath}.dependencies.${name}`);
266
+ }
267
+ };
268
+ inspect(schema, path);
269
+ if (profile === 'strict' && !schemaValidator.validateSchema(schema)) {
270
+ const error = schemaValidator.errors?.[0];
271
+ fail(error?.message ?? 'invalid JSON Schema', 'contract_invalid', `${path}${error?.instancePath ?? ''}`);
218
272
  }
273
+ schemaValidator.compile(schema);
219
274
  }
220
- if (schema.properties !== undefined) {
221
- const properties = requiredRecord(schema.properties, `${path}.properties`);
222
- for (const [key, child] of Object.entries(properties))
223
- validateSchemaProfile(child, `${path}.properties.${key}`);
275
+ catch (error) {
276
+ if (error instanceof AbilityProtocolError)
277
+ throw error;
278
+ fail(error instanceof Error ? error.message : 'invalid JSON Schema', 'contract_invalid', path);
224
279
  }
225
- if (schema.items !== undefined)
226
- validateSchemaProfile(schema.items, `${path}.items`);
227
280
  return schema;
228
281
  }
229
282
  /** Validate an EvolApp definition object read from the public L3 path. */
230
- export function parseAbilityDefinition(value, expected) {
283
+ export function parseAbilityDefinition(value, expected, profile = 'strict') {
231
284
  const d = requiredRecord(value, 'definition');
232
285
  const path = requiredPath(d.path, 'path');
233
286
  if (path.startsWith('protocol/'))
@@ -245,8 +298,8 @@ export function parseAbilityDefinition(value, expected) {
245
298
  const retention = requiredInteger(d.dedupe_retention_seconds, 'dedupe_retention_seconds');
246
299
  if (retention < 1)
247
300
  fail('invalid dedupe retention', 'contract_invalid', 'dedupe_retention_seconds');
248
- const paramsSchema = validateSchemaProfile(d.params_schema, 'params_schema');
249
- const resultSchema = validateSchemaProfile(d.result_schema, 'result_schema');
301
+ const paramsSchema = validateSchemaProfile(d.params_schema, 'params_schema', profile);
302
+ const resultSchema = validateSchemaProfile(d.result_schema, 'result_schema', profile);
250
303
  return {
251
304
  ...d, path, definition_id: definitionId, params_schema: paramsSchema,
252
305
  result_schema: resultSchema, effects, require_confirm: true,
@@ -254,67 +307,45 @@ export function parseAbilityDefinition(value, expected) {
254
307
  aggregation: 'none', dedupe_retention_seconds: retention,
255
308
  };
256
309
  }
257
- function validateSchemaValue(schema, value, path) {
258
- const type = schema.type;
259
- const valid = type === 'object' ? isJsonObject(value)
260
- : type === 'array' ? Array.isArray(value)
261
- : type === 'string' ? typeof value === 'string'
262
- : type === 'integer' ? typeof value === 'number' && Number.isSafeInteger(value)
263
- : type === 'boolean' ? typeof value === 'boolean'
264
- : type === 'null' ? value === null : false;
265
- if (!valid)
266
- fail(`example does not match ${path}`, 'contract_invalid', path);
267
- if (schema.const !== undefined && canonicalJson(schema.const) !== canonicalJson(value)) {
268
- const expected = JSON.stringify(schema.const);
269
- fail(`value at ${path} must equal ${expected.length > 512 ? `${expected.slice(0, 512)}… (see contract for full value)` : expected}`, 'contract_invalid', path);
270
- }
271
- if (Array.isArray(schema.enum) && !schema.enum.some(item => canonicalJson(item) === canonicalJson(value))) {
272
- const allowed = JSON.stringify(schema.enum);
273
- fail(`value at ${path} must be one of ${allowed.length > 512 ? `${allowed.slice(0, 512)}… (see contract for all values)` : allowed}`, 'contract_invalid', path);
274
- }
275
- if (type === 'object') {
276
- const object = value;
277
- const properties = isJsonObject(schema.properties) ? schema.properties : {};
278
- if (Array.isArray(schema.required)) {
279
- for (const key of schema.required)
280
- if (typeof key === 'string' && !Object.prototype.hasOwnProperty.call(object, key)) {
281
- fail(`example is missing ${path}.${key}`, 'contract_invalid', path);
282
- }
283
- }
284
- for (const [key, child] of Object.entries(object)) {
285
- if (Object.hasOwn(properties, key) && isJsonObject(properties[key]))
286
- validateSchemaValue(properties[key], child, `${path}.${key}`);
287
- else if (schema.additionalProperties === false)
288
- fail(`example has unknown ${path}.${key}`, 'contract_invalid', path);
289
- }
290
- }
291
- else if (type === 'array') {
292
- const array = value;
293
- if (typeof schema.minItems === 'number' && array.length < schema.minItems)
294
- fail(`example array is too short`, 'contract_invalid', path);
295
- if (typeof schema.maxItems === 'number' && array.length > schema.maxItems)
296
- fail(`example array is too long`, 'contract_invalid', path);
297
- if (isJsonObject(schema.items))
298
- array.forEach((item, index) => validateSchemaValue(schema.items, item, `${path}[${index}]`));
299
- }
300
- else if (type === 'string') {
301
- const length = [...value].length;
302
- if (typeof schema.minLength === 'number' && length < schema.minLength)
303
- fail(`example string is too short`, 'contract_invalid', path);
304
- if (typeof schema.maxLength === 'number' && length > schema.maxLength)
305
- fail(`example string is too long`, 'contract_invalid', path);
306
- }
307
- else if (type === 'integer') {
308
- if (typeof schema.minimum === 'number' && value < schema.minimum)
309
- fail(`example is below minimum`, 'contract_invalid', path);
310
- if (typeof schema.maximum === 'number' && value > schema.maximum)
311
- fail(`example is above maximum`, 'contract_invalid', path);
312
- }
313
- }
314
- /** Shared Caller-side value validation using the supported wire Schema profile. */
315
- export function validateAbilityValue(schema, value) {
316
- validateSchemaProfile(schema);
317
- validateSchemaValue(schema, value, 'value');
310
+ function schemaErrorPath(errors) {
311
+ const error = errors?.[0];
312
+ if (!error)
313
+ return undefined;
314
+ const pointer = `${error.instancePath || ''}${error.params && 'missingProperty' in error.params ? `/${String(error.params.missingProperty)}` : ''}`;
315
+ const fields = pointer.split('/').slice(1).map(part => part.replace(/~1/g, '/').replace(/~0/g, '~'));
316
+ return fields.length ? `value.${fields.join('.')}` : undefined;
317
+ }
318
+ function schemaAtError(schema, error) {
319
+ if (!error?.schemaPath?.startsWith('#/'))
320
+ return undefined;
321
+ let current = schema;
322
+ for (const part of error.schemaPath.slice(2).split('/').slice(0, -1)) {
323
+ const token = part.replace(/~1/g, '/').replace(/~0/g, '~');
324
+ current = Array.isArray(current) ? current[Number(token)] : current?.[token];
325
+ }
326
+ return current && typeof current === 'object' ? current : undefined;
327
+ }
328
+ function validateSchemaValue(schema, value, path, profile = 'strict') {
329
+ validateSchemaProfile(schema, path, profile);
330
+ const validate = schemaValidator.compile(schema);
331
+ if (!validate(value)) {
332
+ const error = validate.errors?.[0];
333
+ const errorSchema = schemaAtError(schema, error);
334
+ const expected = errorSchema?.const !== undefined ? JSON.stringify(errorSchema.const)
335
+ : Array.isArray(errorSchema?.enum) ? JSON.stringify(errorSchema.enum) : undefined;
336
+ const detail = expected ? `must be one of ${expected}` : error?.message ?? 'does not match the contract';
337
+ fail(`Value ${schemaErrorPath(validate.errors) ?? path} ${detail}`, 'contract_invalid', schemaErrorPath(validate.errors) ?? path);
338
+ }
339
+ }
340
+ /**
341
+ * Best-effort local check of a value against a Provider's schema. It reports
342
+ * what this build can interpret; anything it cannot interpret is skipped, and
343
+ * the Provider remains the authority. A false pass costs one round trip; a
344
+ * false reject would refuse a call the Provider would have accepted.
345
+ */
346
+ export function validateAbilityValue(schema, value, profile = 'lenient') {
347
+ validateSchemaProfile(schema, 'schema', profile);
348
+ validateSchemaValue(schema, value, 'value', profile);
318
349
  }
319
350
  function canonicalJson(value) {
320
351
  if (value === null || typeof value === 'string' || typeof value === 'boolean')
@@ -337,16 +368,25 @@ export function canonicalizeAbilityJson(value) {
337
368
  export function sha256Hex(value) {
338
369
  return createHash('sha256').update(value, 'utf8').digest('hex');
339
370
  }
340
- /** Match AbilityRelease.id from EvolApp (SHA-256 over canonical release content). */
341
- export function abilityReleaseId(pluginVersion, definition, usage) {
342
- return sha256Hex(canonicalJson({ plugin_version: pluginVersion, definition, usage }));
343
- }
344
- export function parseAbilityRelease(value, expected) {
371
+ /**
372
+ * Match AbilityRelease.id from EvolApp (SHA-256 over canonical release content).
373
+ * EvolApp includes the release-level `authorization` block in the digest when it
374
+ * is present; older releases without it digest plugin_version/definition/usage only.
375
+ */
376
+ export function abilityReleaseId(pluginVersion, definition, usage, authorization) {
377
+ return sha256Hex(canonicalJson(authorization === undefined
378
+ ? { plugin_version: pluginVersion, definition, usage }
379
+ : { authorization, plugin_version: pluginVersion, definition, usage }));
380
+ }
381
+ export function parseAbilityRelease(value, expected, profile = 'strict') {
345
382
  const snapshot = requiredRecord(value, 'release');
346
- if (snapshot.schema !== ABILITY_RELEASE_SCHEMA || typeof snapshot.plugin_version !== 'string' || !SEMVER_RE.test(snapshot.plugin_version)) {
383
+ if (snapshot.schema !== ABILITY_RELEASE_SCHEMA && snapshot.schema !== 'aun.ability.release.v2') {
384
+ fail('unsupported release schema', 'contract_invalid', 'schema');
385
+ }
386
+ if (typeof snapshot.plugin_version !== 'string' || !SEMVER_RE.test(snapshot.plugin_version)) {
347
387
  fail('invalid release snapshot', 'contract_invalid');
348
388
  }
349
- const definition = parseAbilityDefinition(snapshot.definition, expected);
389
+ const definition = parseAbilityDefinition(snapshot.definition, expected, profile);
350
390
  const usage = requiredRecord(snapshot.usage, 'usage');
351
391
  if (usage.schema !== ABILITY_USAGE_SCHEMA || usage.path !== definition.path || usage.definition_id !== definition.definition_id
352
392
  || !Array.isArray(usage.examples) || usage.examples.length === 0
@@ -356,15 +396,18 @@ export function parseAbilityRelease(value, expected) {
356
396
  fail('release usage does not match definition', 'contract_invalid', 'usage');
357
397
  }
358
398
  for (const [index, example] of usage.examples.entries()) {
359
- validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`);
399
+ validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`, profile);
360
400
  }
361
401
  const releaseId = validateReleaseId(snapshot.release_id);
362
- const calculated = abilityReleaseId(snapshot.plugin_version, definition, usage);
402
+ const authorization = snapshot.authorization === undefined ? undefined : requiredRecord(snapshot.authorization, 'authorization');
403
+ if (snapshot.schema === 'aun.ability.release.v2' && !authorization)
404
+ fail('v2 release requires authorization', 'contract_invalid', 'authorization');
405
+ const calculated = abilityReleaseId(snapshot.plugin_version, definition, usage, authorization);
363
406
  if (releaseId !== calculated)
364
407
  fail('release_id does not match snapshot content', 'contract_invalid', 'release_id');
365
408
  return {
366
- schema: ABILITY_RELEASE_SCHEMA, plugin_version: snapshot.plugin_version,
367
- release_id: releaseId, definition, usage,
409
+ schema: snapshot.schema, plugin_version: snapshot.plugin_version,
410
+ release_id: releaseId, definition, usage, ...(authorization ? { authorization } : {}),
368
411
  };
369
412
  }
370
413
  export function parseAbilityIndex(value, expectedPublisher) {
@@ -1,7 +1,7 @@
1
1
  import fs from 'node:fs';
2
2
  import path from 'node:path';
3
3
  import { createHash, randomUUID } from 'node:crypto';
4
- import { atomicWriteJson, withFileLock } from '../utils/atomic-write.js';
4
+ import { atomicWriteJson } from '../utils/atomic-write.js';
5
5
  import { resolveRoot } from '../paths.js';
6
6
  import { templateError } from './types.js';
7
7
  export const TEMPLATE_JOB_ID = /^job_[a-f0-9-]{36}$/;
@@ -48,7 +48,7 @@ export function recordTemplateNoticeReceipt(root, noticeId, ownerAid, messageId,
48
48
  throw templateError('INVALID_ARGUMENT', 'Invalid update notice receipt');
49
49
  const jobs = new TemplateJobs(root);
50
50
  const file = path.join(jobs.directory, 'notifications', noticeId + '.json');
51
- jobs.assertTeamPath(file);
51
+ jobs.assertStatePath(file);
52
52
  if (!fs.existsSync(file))
53
53
  return;
54
54
  const notice = JSON.parse(fs.readFileSync(file, 'utf8'));
@@ -93,8 +93,9 @@ export class TemplateJobs {
93
93
  throw templateError('CONFLICT', 'Template job revision changed', { jobId: job.jobId });
94
94
  }
95
95
  if (!current.committed && job.committed && (current.status !== 'running' || !current.activating
96
- || job.status !== 'succeeded' || !Object.values(job.members).every(member => member.runtimeReady
97
- || job.checkpoint.installMode === 'overwrite' && job.checkpoint.runtimeInactive === true))) {
96
+ || job.status !== 'succeeded' || !Object.entries(job.members).every(([key, member]) => member.runtimeReady
97
+ || job.checkpoint.installMode === 'overwrite' && job.checkpoint.runtimeInactive === true
98
+ || job.checkpoint.modelUnavailable?.includes(key)))) {
98
99
  throw templateError('CONFLICT', 'Only the current prepared deployment can commit');
99
100
  }
100
101
  }
@@ -114,8 +115,10 @@ export class TemplateJobs {
114
115
  requestMatches(actor, requestId, action, args) {
115
116
  const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
116
117
  const fingerprint = templateFingerprint({ action, args });
117
- return fs.existsSync(file) ? JSON.parse(fs.readFileSync(file, 'utf8')).fingerprint === fingerprint
118
- : this.original(actor, requestId)?.fingerprint === fingerprint;
118
+ if (fs.existsSync(file))
119
+ return JSON.parse(fs.readFileSync(file, 'utf8')).fingerprint === fingerprint;
120
+ const original = this.original(actor, requestId);
121
+ return original?.fingerprint === fingerprint;
119
122
  }
120
123
  bindRequest(actor, requestId, action, args, jobId) {
121
124
  const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
@@ -186,7 +189,7 @@ export class TemplateJobs {
186
189
  if (!/^[a-z0-9][a-z0-9_-]*(\.[a-z0-9-]+)+$/.test(aid))
187
190
  throw templateError('INVALID_ARGUMENT', 'Invalid target AID');
188
191
  const file = path.join(this.root, 'agents', aid, 'template.lock.json');
189
- this.assertTeamPath(file);
192
+ this.assertStatePath(file);
190
193
  return file;
191
194
  }
192
195
  /** A staged lock never exposes its candidate as an installed version before commit. */
@@ -208,121 +211,22 @@ export class TemplateJobs {
208
211
  }
209
212
  return value;
210
213
  }
211
- /** The slot reservation and request/job link share a cross-process admission lock. */
212
- withTeams(run) {
213
- this.assertTeamPath(path.join(this.directory, 'teams', 'state.lock'));
214
- return withFileLock(path.join(this.directory, 'teams', 'state.lock'), run);
215
- }
216
- teamFile(id) {
217
- if (!/^team_[a-f0-9]{64}$/.test(id))
218
- throw templateError('INVALID_ARGUMENT', 'Invalid instanceId');
219
- const file = path.join(this.directory, 'teams', id, 'instance.json');
220
- this.assertTeamPath(file);
221
- return file;
222
- }
223
- listTeams() {
224
- const directory = path.join(this.directory, 'teams');
225
- if (!fs.existsSync(directory))
226
- return [];
227
- return fs.readdirSync(directory, { withFileTypes: true }).filter(entry => /^team_[a-f0-9]{64}$/.test(entry.name))
228
- .map(entry => {
229
- this.assertTeamPath(path.join(directory, entry.name, 'instance.json'));
230
- return this.readTeam(entry.name);
231
- });
232
- }
233
214
  /** Fixed paths below the runtime root cannot traverse links or non-directory ancestors. */
234
- assertTeamPath(file) {
215
+ assertStatePath(file) {
235
216
  const root = path.resolve(this.root);
236
217
  const target = path.resolve(file);
237
218
  const relative = path.relative(root, target);
238
219
  if (relative.startsWith('..' + path.sep) || relative === '..' || path.isAbsolute(relative))
239
- throw templateError('UNSAFE_DEFINITION_PATH', 'Team definition leaves the runtime root');
220
+ throw templateError('UNSAFE_TEMPLATE_PATH', 'Template state leaves the runtime root');
240
221
  let current = root;
241
222
  for (const segment of ['', ...relative.split(path.sep)]) {
242
223
  current = segment ? path.join(current, segment) : current;
243
224
  const stat = fs.lstatSync(current, { throwIfNoEntry: false });
244
225
  if (stat?.isSymbolicLink() || stat && current !== target && !stat.isDirectory()) {
245
- throw templateError('UNSAFE_DEFINITION_PATH', 'Team paths must use ordinary directories and files');
226
+ throw templateError('UNSAFE_TEMPLATE_PATH', 'Template paths must use ordinary directories and files');
246
227
  }
247
228
  }
248
229
  }
249
- definitionFiles() {
250
- const directory = path.join(this.directory, 'team-definitions');
251
- this.assertTeamPath(directory);
252
- if (!fs.existsSync(directory))
253
- return [];
254
- if (!fs.lstatSync(directory).isDirectory())
255
- throw templateError('UNSAFE_DEFINITION_PATH', 'Team definitions must be a directory');
256
- const files = fs.readdirSync(directory).filter(name => name.endsWith('.json')).sort();
257
- if (files.length > 1000)
258
- throw templateError('INVALID_ARGUMENT', 'Too many Team definitions');
259
- return files;
260
- }
261
- readDefinition(file) {
262
- if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,127}\.json$/.test(file))
263
- throw templateError('UNSAFE_DEFINITION_PATH', 'Invalid Team definition filename');
264
- const target = path.join(this.directory, 'team-definitions', file);
265
- this.assertTeamPath(target);
266
- const before = fs.lstatSync(target);
267
- if (!before.isFile() || before.nlink !== 1 || before.size > 1024 * 1024)
268
- throw templateError('UNSAFE_DEFINITION_PATH', 'A bounded ordinary Team definition file is required');
269
- if (process.platform !== 'win32' && (before.mode & 0o077) !== 0)
270
- throw templateError('UNSAFE_DEFINITION_PERMISSIONS', 'Team definition must be private (0600)');
271
- const handle = fs.openSync(target, fs.constants.O_RDONLY | (fs.constants.O_NOFOLLOW ?? 0));
272
- try {
273
- const opened = fs.fstatSync(handle);
274
- if (before.ino !== opened.ino || before.dev !== opened.dev)
275
- throw templateError('SOURCE_CHANGED', 'Team definition changed while opening');
276
- const content = fs.readFileSync(handle, 'utf8');
277
- const after = fs.fstatSync(handle);
278
- this.assertTeamPath(target);
279
- const present = fs.lstatSync(target);
280
- if (after.size !== before.size || after.mtimeMs !== before.mtimeMs || after.ctimeMs !== before.ctimeMs
281
- || present.ino !== after.ino || present.dev !== after.dev)
282
- throw templateError('SOURCE_CHANGED', 'Team definition changed while reading');
283
- return JSON.parse(content);
284
- }
285
- finally {
286
- fs.closeSync(handle);
287
- }
288
- }
289
- readTeam(id) {
290
- const file = this.teamFile(id);
291
- if (!fs.existsSync(file))
292
- throw templateError('NOT_FOUND', 'Team instance not found');
293
- const value = JSON.parse(fs.readFileSync(file, 'utf8'));
294
- if (value.version !== 1 || value.instanceId !== id || !Array.isArray(value.members)
295
- || !/^sha256:[a-f0-9]{64}$/.test(value.revision))
296
- throw templateError('RECOVERY_REQUIRED', 'Invalid team instance');
297
- return value;
298
- }
299
- saveTeam(team, expectedRevision) {
300
- const file = this.teamFile(team.instanceId);
301
- if (fs.existsSync(file) && this.readTeam(team.instanceId).revision !== expectedRevision) {
302
- throw templateError('CONFLICT', 'Team revision changed');
303
- }
304
- const { revision: _revision, ...content } = team;
305
- team.updatedAt = Date.now();
306
- team.revision = 'sha256:' + templateFingerprint({ ...content, updatedAt: team.updatedAt });
307
- writeTemplateState(file, team);
308
- }
309
- installFile(id) {
310
- if (!/^member_install_[a-f0-9-]{36}$/.test(id))
311
- throw templateError('INVALID_ARGUMENT', 'Invalid memberInstallId');
312
- return path.join(this.directory, 'member-installs', id + '.json');
313
- }
314
- readMemberInstall(actor, id) {
315
- const file = this.installFile(id);
316
- if (!fs.existsSync(file))
317
- throw templateError('NOT_FOUND', 'Member installation not found');
318
- const value = JSON.parse(fs.readFileSync(file, 'utf8'));
319
- if (value.memberInstallId !== id || value.actor !== actor)
320
- throw templateError('NOT_FOUND', 'Member installation not found');
321
- return value;
322
- }
323
- saveMemberInstall(value) {
324
- writeTemplateState(this.installFile(value.memberInstallId), value);
325
- }
326
230
  }
327
231
  /** Durable installation associations are checked before ordinary task dispatch. */
328
232
  export function templateInstallationGate(aid, expectedJobId, root = resolveRoot()) {
@@ -346,7 +250,7 @@ export function templateInstallationGate(aid, expectedJobId, root = resolveRoot(
346
250
  }
347
251
  }
348
252
  const job = new TemplateJobs(root).read(link.jobId);
349
- if (job.action !== 'deploy' || !Object.values(job.members).some(member => member.aid === aid))
253
+ if (!['deploy', 'upgrade'].includes(job.action) || !Object.values(job.members).some(member => member.aid === aid))
350
254
  throw new Error('Invalid member');
351
255
  return { jobId: job.jobId, blocked: job.committed !== true && job.checkpoint.restored !== true,
352
256
  activating: job.status === 'running' && job.activating === true, executing: job.status === 'running' };