evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -1,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,60 +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
- fail(`example does not match ${path}.const`, 'contract_invalid', path);
269
- }
270
- if (Array.isArray(schema.enum) && !schema.enum.some(item => canonicalJson(item) === canonicalJson(value))) {
271
- fail(`example does not match ${path}.enum`, 'contract_invalid', path);
272
- }
273
- if (type === 'object') {
274
- const object = value;
275
- const properties = isJsonObject(schema.properties) ? schema.properties : {};
276
- if (Array.isArray(schema.required)) {
277
- for (const key of schema.required)
278
- if (typeof key === 'string' && !Object.prototype.hasOwnProperty.call(object, key)) {
279
- fail(`example is missing ${path}.${key}`, 'contract_invalid', path);
280
- }
281
- }
282
- for (const [key, child] of Object.entries(object)) {
283
- if (isJsonObject(properties[key]))
284
- validateSchemaValue(properties[key], child, `${path}.${key}`);
285
- else if (schema.additionalProperties === false)
286
- fail(`example has unknown ${path}.${key}`, 'contract_invalid', path);
287
- }
288
- }
289
- else if (type === 'array') {
290
- const array = value;
291
- if (typeof schema.minItems === 'number' && array.length < schema.minItems)
292
- fail(`example array is too short`, 'contract_invalid', path);
293
- if (typeof schema.maxItems === 'number' && array.length > schema.maxItems)
294
- fail(`example array is too long`, 'contract_invalid', path);
295
- if (isJsonObject(schema.items))
296
- array.forEach((item, index) => validateSchemaValue(schema.items, item, `${path}[${index}]`));
297
- }
298
- else if (type === 'string') {
299
- const length = [...value].length;
300
- if (typeof schema.minLength === 'number' && length < schema.minLength)
301
- fail(`example string is too short`, 'contract_invalid', path);
302
- if (typeof schema.maxLength === 'number' && length > schema.maxLength)
303
- fail(`example string is too long`, 'contract_invalid', path);
304
- }
305
- else if (type === 'integer') {
306
- if (typeof schema.minimum === 'number' && value < schema.minimum)
307
- fail(`example is below minimum`, 'contract_invalid', path);
308
- if (typeof schema.maximum === 'number' && value > schema.maximum)
309
- fail(`example is above maximum`, 'contract_invalid', path);
310
- }
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);
311
349
  }
312
350
  function canonicalJson(value) {
313
351
  if (value === null || typeof value === 'string' || typeof value === 'boolean')
@@ -330,16 +368,25 @@ export function canonicalizeAbilityJson(value) {
330
368
  export function sha256Hex(value) {
331
369
  return createHash('sha256').update(value, 'utf8').digest('hex');
332
370
  }
333
- /** Match AbilityRelease.id from EvolApp (SHA-256 over canonical release content). */
334
- export function abilityReleaseId(pluginVersion, definition, usage) {
335
- return sha256Hex(canonicalJson({ plugin_version: pluginVersion, definition, usage }));
336
- }
337
- 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') {
338
382
  const snapshot = requiredRecord(value, 'release');
339
- 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)) {
340
387
  fail('invalid release snapshot', 'contract_invalid');
341
388
  }
342
- const definition = parseAbilityDefinition(snapshot.definition, expected);
389
+ const definition = parseAbilityDefinition(snapshot.definition, expected, profile);
343
390
  const usage = requiredRecord(snapshot.usage, 'usage');
344
391
  if (usage.schema !== ABILITY_USAGE_SCHEMA || usage.path !== definition.path || usage.definition_id !== definition.definition_id
345
392
  || !Array.isArray(usage.examples) || usage.examples.length === 0
@@ -349,15 +396,18 @@ export function parseAbilityRelease(value, expected) {
349
396
  fail('release usage does not match definition', 'contract_invalid', 'usage');
350
397
  }
351
398
  for (const [index, example] of usage.examples.entries()) {
352
- validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`);
399
+ validateSchemaValue(definition.params_schema, example.params, `usage.examples[${index}].params`, profile);
353
400
  }
354
401
  const releaseId = validateReleaseId(snapshot.release_id);
355
- 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);
356
406
  if (releaseId !== calculated)
357
407
  fail('release_id does not match snapshot content', 'contract_invalid', 'release_id');
358
408
  return {
359
- schema: ABILITY_RELEASE_SCHEMA, plugin_version: snapshot.plugin_version,
360
- release_id: releaseId, definition, usage,
409
+ schema: snapshot.schema, plugin_version: snapshot.plugin_version,
410
+ release_id: releaseId, definition, usage, ...(authorization ? { authorization } : {}),
361
411
  };
362
412
  }
363
413
  export function parseAbilityIndex(value, expectedPublisher) {
@@ -8,6 +8,7 @@ export function parseAbilityArgv(argv, context = {}) {
8
8
  abilityAssert(Array.isArray(argv) && argv[0] === 'ability', 'ARGUMENT_INVALID', 'Expected ability command');
9
9
  const [, operation, ...args] = argv;
10
10
  abilityAssert(Object.hasOwn(ABILITY_COMMANDS, operation), 'ACTION_UNSUPPORTED', 'Unknown ability command');
11
+ abilityAssert(operation !== 'remote', 'ACTION_UNSUPPORTED', 'Remote commands require the managed ability.remote.op endpoint');
11
12
  const { values, positional } = parseAbilityOptions(args, ABILITY_COMMANDS[operation]);
12
13
  let input = {};
13
14
  if (values.file) {
@@ -6,6 +6,17 @@ import { resolveRoot } from '../paths.js';
6
6
  import { templateError } from './types.js';
7
7
  export const TEMPLATE_JOB_ID = /^job_[a-f0-9-]{36}$/;
8
8
  export const TEMPLATE_PREVIEW_ID = /^preview_[a-f0-9-]{36}$/;
9
+ export function compareTemplateVersions(left, right) {
10
+ const version = /^(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)\.(0|[1-9][0-9]*)$/;
11
+ if (!version.test(left) || !version.test(right))
12
+ throw templateError('VERSION_MISSING', 'Three numeric author member version components required');
13
+ const a = left.split('.').map(BigInt);
14
+ const b = right.split('.').map(BigInt);
15
+ for (let i = 0; i < 3; i++)
16
+ if (a[i] !== b[i])
17
+ return a[i] > b[i] ? 1 : -1;
18
+ return 0;
19
+ }
9
20
  export function templateFingerprint(value) {
10
21
  return createHash('sha256').update(JSON.stringify(value, (_key, item) => item && typeof item === 'object' && !Array.isArray(item)
11
22
  ? Object.fromEntries(Object.keys(item).sort().map(key => [key, item[key]])) : item)).digest('hex');
@@ -31,6 +42,20 @@ export function writeTemplateState(file, value) {
31
42
  }
32
43
  }
33
44
  }
45
+ /** Copy the transport receipt before outbox retirement; acceptance never marks the App notification read. */
46
+ export function recordTemplateNoticeReceipt(root, noticeId, ownerAid, messageId, outboxId) {
47
+ if (!/^notice_[a-f0-9]{64}$/.test(noticeId))
48
+ throw templateError('INVALID_ARGUMENT', 'Invalid update notice receipt');
49
+ const jobs = new TemplateJobs(root);
50
+ const file = path.join(jobs.directory, 'notifications', noticeId + '.json');
51
+ jobs.assertStatePath(file);
52
+ if (!fs.existsSync(file))
53
+ return;
54
+ const notice = JSON.parse(fs.readFileSync(file, 'utf8'));
55
+ if (notice.ownerAid !== ownerAid || notice.noticeId !== noticeId)
56
+ throw templateError('NOT_ALLOWED', 'Notice receipt route differs');
57
+ writeTemplateState(file, { ...notice, delivery: 'accepted', status: 'transport-accepted', messageId, outboxId });
58
+ }
34
59
  export class TemplateJobs {
35
60
  root;
36
61
  directory;
@@ -68,8 +93,9 @@ export class TemplateJobs {
68
93
  throw templateError('CONFLICT', 'Template job revision changed', { jobId: job.jobId });
69
94
  }
70
95
  if (!current.committed && job.committed && (current.status !== 'running' || !current.activating
71
- || job.status !== 'succeeded' || !Object.values(job.members).every(member => member.runtimeReady
72
- || 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)))) {
73
99
  throw templateError('CONFLICT', 'Only the current prepared deployment can commit');
74
100
  }
75
101
  }
@@ -86,6 +112,14 @@ export class TemplateJobs {
86
112
  return this.read(JSON.parse(fs.readFileSync(requestFile, 'utf8')).jobId);
87
113
  return this.list().find(job => job.actor === actor && job.requestId === requestId);
88
114
  }
115
+ requestMatches(actor, requestId, action, args) {
116
+ const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
117
+ const fingerprint = templateFingerprint({ action, args });
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;
122
+ }
89
123
  bindRequest(actor, requestId, action, args, jobId) {
90
124
  const file = path.join(this.directory, 'requests', templateFingerprint({ actor, requestId }) + '.json');
91
125
  const fingerprint = templateFingerprint({ action, args });
@@ -151,6 +185,48 @@ export class TemplateJobs {
151
185
  for (const { aid, file } of files)
152
186
  writeTemplateState(file, { aid, jobId: job.jobId });
153
187
  }
188
+ installationFile(aid) {
189
+ if (!/^[a-z0-9][a-z0-9_-]*(\.[a-z0-9-]+)+$/.test(aid))
190
+ throw templateError('INVALID_ARGUMENT', 'Invalid target AID');
191
+ const file = path.join(this.root, 'agents', aid, 'template.lock.json');
192
+ this.assertStatePath(file);
193
+ return file;
194
+ }
195
+ /** A staged lock never exposes its candidate as an installed version before commit. */
196
+ installation(aid) {
197
+ const file = this.installationFile(aid);
198
+ if (!fs.existsSync(file))
199
+ return null;
200
+ const lock = JSON.parse(fs.readFileSync(file, 'utf8'));
201
+ if (lock.schemaVersion !== 2)
202
+ return null;
203
+ const value = lock.pending && this.read(lock.pending.jobId).committed === true
204
+ ? lock.pending.installation : lock.installation;
205
+ if (!value)
206
+ return null;
207
+ if (value.targetAid !== aid || !value.source || !value.baseline
208
+ || value.committedJobId && (this.read(value.committedJobId).committed !== true
209
+ || !Object.values(this.read(value.committedJobId).members).some(member => member.aid === aid))) {
210
+ throw templateError('RECOVERY_REQUIRED', 'Installed template provenance is invalid');
211
+ }
212
+ return value;
213
+ }
214
+ /** Fixed paths below the runtime root cannot traverse links or non-directory ancestors. */
215
+ assertStatePath(file) {
216
+ const root = path.resolve(this.root);
217
+ const target = path.resolve(file);
218
+ const relative = path.relative(root, target);
219
+ if (relative.startsWith('..' + path.sep) || relative === '..' || path.isAbsolute(relative))
220
+ throw templateError('UNSAFE_TEMPLATE_PATH', 'Template state leaves the runtime root');
221
+ let current = root;
222
+ for (const segment of ['', ...relative.split(path.sep)]) {
223
+ current = segment ? path.join(current, segment) : current;
224
+ const stat = fs.lstatSync(current, { throwIfNoEntry: false });
225
+ if (stat?.isSymbolicLink() || stat && current !== target && !stat.isDirectory()) {
226
+ throw templateError('UNSAFE_TEMPLATE_PATH', 'Template paths must use ordinary directories and files');
227
+ }
228
+ }
229
+ }
154
230
  }
155
231
  /** Durable installation associations are checked before ordinary task dispatch. */
156
232
  export function templateInstallationGate(aid, expectedJobId, root = resolveRoot()) {
@@ -174,7 +250,7 @@ export function templateInstallationGate(aid, expectedJobId, root = resolveRoot(
174
250
  }
175
251
  }
176
252
  const job = new TemplateJobs(root).read(link.jobId);
177
- 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))
178
254
  throw new Error('Invalid member');
179
255
  return { jobId: job.jobId, blocked: job.committed !== true && job.checkpoint.restored !== true,
180
256
  activating: job.status === 'running' && job.activating === true, executing: job.status === 'running' };