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,12 +1,19 @@
1
1
  import { randomUUID, createHash } from 'node:crypto';
2
2
  import { AbilityStore } from '../store.js';
3
- import { isJsonObject, validateAbilityResult, canonicalizeAbilityJson } from '../interop-v1.js';
4
- import { isAidWideDeviceStatusQuery } from '../../aun/ability-device-routing.js';
3
+ import { AbilityProtocolError, isJsonObject, validateAbilityResult, canonicalizeAbilityJson } from '../interop-v1.js';
5
4
  import { durationSeconds, remoteAssert, RemoteError, REMOTE_CLI_VERSION } from './command.js';
6
- import { boundedJson, parseCapability, parseRemoteIndex, sameProviderPath, validateValue, parseRemoteContract } from './contract.js';
5
+ import { boundedJson, parseCapability, parseRemoteIndex, sameProviderPath, validateValue, validateAuthorization, parseRemoteContract } from './contract.js';
6
+ import { approvedCredentialTargets, credentialTargetsFromParams, saveCredentialForTarget } from './credential-files.js';
7
+ import { compactSchema, viewParamsSchema } from './schema-view.js';
7
8
  const digest = (value) => createHash('sha256').update(canonicalizeAbilityJson(value)).digest('hex');
8
9
  const requestKey = (context, request) => digest([context.callerAid, request]);
9
10
  const operationKey = (context, provider, operation) => digest([context.callerAid, provider, operation]);
11
+ const applicationKey = (context, provider, applicationId) => digest([context.callerAid, provider, applicationId]);
12
+ function discoveryCurrentKey(context, provider) {
13
+ const { callerAid, sessionId, peerKey, threadId } = context;
14
+ // Omit the main topic's undefined thread ID without changing existing topic keys.
15
+ return digest([{ callerAid, sessionId, peerKey, ...(threadId === undefined ? {} : { threadId }) }, provider]);
16
+ }
10
17
  function sameScope(value, context) {
11
18
  return value.callerAid === context.callerAid && value.sessionId === context.sessionId
12
19
  && value.peerKey === context.peerKey && value.threadId === context.threadId;
@@ -15,22 +22,26 @@ function response(data, ok = true, code) {
15
22
  return { schema_version: REMOTE_CLI_VERSION, ok, ...(code ? { code } : {}), data };
16
23
  }
17
24
  export function remoteFailure(error) {
18
- const code = error instanceof RemoteError ? error.code : 'REMOTE_ABILITY_FAILED';
25
+ // Ability contract/schema violations carry their own code; anything else is
26
+ // reported as an unexpected caller failure rather than silently swallowed.
27
+ const protocol = error instanceof AbilityProtocolError ? error : undefined;
28
+ const code = error instanceof RemoteError ? error.code : protocol ? protocol.code.toUpperCase() : 'REMOTE_ABILITY_FAILED';
19
29
  const data = error instanceof RemoteError ? error.data : undefined;
20
30
  const denied = ['NOT_ALLOWED', 'NO_PERMISSION', 'ROLE_ACCESS_DENIED', 'SCOPE_MISMATCH', 'DELEGATION_REQUIRED', 'INVALID_DELEGATION'].includes(code);
21
31
  return { schema_version: REMOTE_CLI_VERSION, ok: false,
22
32
  code,
23
- error: error instanceof RemoteError ? error.message : 'Remote Ability operation failed',
33
+ error: error instanceof RemoteError ? error.message : protocol ? protocol.message : 'Remote Ability operation failed',
24
34
  ...(data ? { data } : {}),
25
- ...(code === 'PARAMS_INVALID' ? { stage: 'validation', sent: false } : {}),
35
+ ...(['PARAMS_INVALID', 'AUTHORIZATION_REQUIRED', 'CREDENTIAL_INVALID'].includes(code) ? { stage: 'validation', sent: false } : {}),
26
36
  ...(denied ? { next_action: { action: 'stop', reason: 'Permission denied; report the reason. Do not retry through another identity or transport.', resend_allowed: false } }
27
37
  : code === 'PARAMS_INVALID' ? { next_action: { action: 'correct_params', reason: 'Use this capability’s current params_schema and allowed values. Read remote info only if the contract is missing; no request was sent.' } }
28
- : data?.usage ? { next_action: { usage: data.usage } } : {}) };
38
+ : code === 'AUTHORIZATION_REQUIRED' ? { next_action: { action: 'obtain_credential', command: data?.next_command, authorization: data?.authorization, resend_allowed: false } }
39
+ : data?.usage ? { next_action: { usage: data.usage } } : {}) };
29
40
  }
30
41
  export function remoteExitCode(result) {
31
42
  return result.ok ? 0 : ['RESULT_PENDING', 'EXECUTION_UNKNOWN', 'NO_DISCOVERY_RESPONSE', 'DEVICE_SELECTION_REQUIRED', 'CONTRACT_SELECTION_REQUIRED', 'DISCOVERY_REQUIRED'].includes(result.code ?? '') ? 2 : 1;
32
43
  }
33
- /** All durable evidence is daemon-owned; no user-supplied file is a discovery or plan. */
44
+ /** Discovery and plans are daemon-owned; credentials remain with the calling Agent. */
34
45
  export class AbilityCallerService {
35
46
  now;
36
47
  store;
@@ -39,7 +50,7 @@ export class AbilityCallerService {
39
50
  this.store = new AbilityStore(root);
40
51
  }
41
52
  close() { this.store.close(); }
42
- async execute(command, context, transport, params = {}) {
53
+ async execute(command, context, transport, params = {}, credential) {
43
54
  if (command.action === 'result') {
44
55
  const call = this.store.get('call', requestKey(context, command.requestId));
45
56
  remoteAssert(call && sameScope(call, context), 'REQUEST_NOT_FOUND', 'Request is not available in this session and topic');
@@ -48,15 +59,18 @@ export class AbilityCallerService {
48
59
  if (command.action === 'call' && command.options.plan) {
49
60
  const plan = this.store.get('plan', command.options.plan);
50
61
  remoteAssert(plan && sameScope(plan, context), 'PLAN_NOT_FOUND', 'Plan is not available in this session and topic');
51
- return this.dispatch(plan, context, transport);
62
+ return this.dispatch(plan, context, transport, credential);
52
63
  }
53
64
  const provider = command.provider;
54
65
  await transport.authorize(provider, 'read');
55
66
  if (command.action === 'discover')
56
- return this.discover(command, context, transport);
67
+ return this.discover(command, context, transport, credential);
57
68
  const snapshot = await this.discovery(command, context, transport);
58
69
  if (command.action === 'list') {
59
70
  const data = this.discoveryView(snapshot, command.path, command.options);
71
+ data.guide_available = !!snapshot.skillRef;
72
+ if (snapshot.skillRef)
73
+ data.skill_ref = snapshot.skillRef;
60
74
  if (command.options.usage && snapshot.skillRef)
61
75
  data.usage = { untrusted: true, reference: snapshot.skillRef,
62
76
  content: await this.readUsage(snapshot, snapshot.skillRef, transport) };
@@ -75,52 +89,82 @@ export class AbilityCallerService {
75
89
  ...snapshot.capabilities.filter(row => row.path === selected.path && row.definition_id === selected.definition_id)]);
76
90
  const { definition } = contract;
77
91
  if (command.action === 'info') {
78
- const view = this.discoveryView(snapshot, command.path, command.options);
79
- if (!command.options.full) {
92
+ const view = this.discoveryView(snapshot, command.path, command.options, false);
93
+ if (!command.options.full)
80
94
  delete view.capabilities;
81
- delete view.pagination;
82
- }
83
- const data = { ...view, definition, definition_id: definition.definition_id,
95
+ const { params_schema, result_schema, ...definitionMeta } = definition;
96
+ const schemas = command.options.schema ?? 'both';
97
+ const paramsView = schemas !== 'result' || command.options.action ? viewParamsSchema(params_schema, command.options.action) : undefined;
98
+ const data = { ...view,
99
+ definition: { ...definitionMeta, ...(schemas !== 'result' ? { params_schema: paramsView.schema } : {}),
100
+ ...(schemas !== 'params' ? { result_schema: compactSchema(result_schema) } : {}) },
101
+ ...(paramsView?.action !== undefined ? { action: paramsView.action } : {}),
102
+ definition_id: definition.definition_id,
84
103
  devices: this.candidates(snapshot, command.path),
85
- detail_ref: selected.detail_ref, ...(contract.release ? { release: contract.release } : {}) };
104
+ detail_ref: selected.detail_ref, ...(contract.release ? { release: contract.release } : {}),
105
+ ...(contract.authorization ? { authorization: contract.authorization } : {}) };
86
106
  if (command.options.usage) {
87
107
  const reference = selected.usage_ref ?? snapshot.skillRef;
88
108
  if (contract.usage)
89
109
  data.usage = { untrusted: true, reference: selected.detail_ref, content: contract.usage };
90
110
  else if (reference)
91
111
  data.usage = { untrusted: true, reference, content: await this.readUsage(snapshot, reference, transport) };
112
+ if (data.usage) {
113
+ const references = [...new Set([selected.usage_ref, snapshot.skillRef])]
114
+ .filter((ref) => !!ref && ref !== data.usage.reference);
115
+ if (references.length)
116
+ data.usage.additional_documents = await Promise.all(references.map(async (ref) => ({
117
+ untrusted: true, reference: ref, content: await this.readUsage(snapshot, ref, transport),
118
+ })));
119
+ }
92
120
  }
93
121
  return response(data);
94
122
  }
95
123
  remoteAssert(isJsonObject(params), 'PARAMS_INVALID', 'Business params must be a JSON object');
96
124
  validateValue(definition.params_schema, params, 'PARAMS_INVALID');
97
- const aidWide = isAidWideDeviceStatusQuery({ type: 'ability', role: 'call', ability_path: command.path, params });
98
125
  const candidates = selected.devices ?? [];
99
- let deviceId = command.options['device-id'];
100
- if (aidWide)
101
- remoteAssert(!deviceId, 'ABILITY_DEVICE_NOT_ALLOWED', 'device/status read collects all responding devices; omit --device-id');
102
- else {
103
- remoteAssert(candidates.length, 'DISCOVERY_REQUIRED', 'No device evidence for this capability; run remote discover', { provider_aid: provider, ability_path: command.path });
104
- if (deviceId)
105
- remoteAssert(candidates.includes(deviceId), 'DEVICE_NOT_DISCOVERED', 'Selected device does not publish this capability');
106
- else {
107
- remoteAssert(candidates.length === 1, 'DEVICE_SELECTION_REQUIRED', 'Choose a device with --device-id', { devices: this.candidates(snapshot, command.path) });
108
- deviceId = candidates[0];
109
- }
126
+ const deviceId = command.options['device-id'];
127
+ this.checkAuthorization(contract.authorization, !!credential, deviceId, command.path, provider, definition.definition_id);
128
+ // Omitting --device-id is a broadcast, not an error: the Provider routes the
129
+ // call to its online devices and the first terminal reply finishes the call.
130
+ // A named device must still come from this Provider's discovery evidence —
131
+ // otherwise it is a guess about someone else's routing.
132
+ if (deviceId) {
133
+ remoteAssert(candidates.includes(deviceId), 'DEVICE_NOT_DISCOVERED', 'Selected device does not publish this capability', { provider_aid: provider, ability_path: command.path, devices: this.candidates(snapshot, command.path) });
110
134
  }
135
+ // Omitting --device-id needs no device evidence: the index may not list
136
+ // devices at all, and the Provider is the one that knows which are online.
111
137
  const timeout = durationSeconds(command.options.timeout ?? '60s');
112
138
  const ttl = durationSeconds(command.options.ttl ?? String(timeout));
113
139
  const operationId = command.options['operation-id'] ?? `op-${randomUUID()}`;
114
140
  const plan = { ...context, id: `plan-${randomUUID()}`, provider, path: command.path, definition, deviceId,
115
- params, timeout, ttl, operationId, discoveryId: snapshot.id, expiresAt: Math.min(this.now() + 300_000, snapshot.expiresAt),
141
+ params, timeout, ttl, operationId, authorization: contract.authorization,
142
+ discoveryId: snapshot.id, expiresAt: Math.min(this.now() + 300_000, snapshot.expiresAt),
116
143
  fingerprint: digest([provider, deviceId ?? null, command.path, definition.definition_id, params, ttl, timeout, false]) };
117
144
  if (command.options['dry-run']) {
118
145
  this.store.put('plan', plan.id, context.callerAid, plan);
119
146
  return { ...response({ plan_id: plan.id, provider_aid: provider, ability_path: plan.path, definition_id: definition.definition_id,
120
147
  device_id: deviceId, params, timeout_seconds: timeout, ttl_seconds: ttl, operation_id: operationId,
121
- selection_source: snapshot.source, expires_at: plan.expiresAt, require_confirm: definition.require_confirm, auth_required: definition.auth_required }), sent: false };
148
+ selection_source: snapshot.source, expires_at: plan.expiresAt, require_confirm: definition.require_confirm, auth_required: definition.auth_required,
149
+ ...(contract.authorization ? { authorization: contract.authorization } : {}) }), sent: false };
122
150
  }
123
- return this.dispatch(plan, context, transport);
151
+ return this.dispatch(plan, context, transport, credential);
152
+ }
153
+ checkAuthorization(authorization, hasCredential, deviceId, abilityPath, provider, definitionId) {
154
+ if (hasCredential)
155
+ remoteAssert(deviceId, 'DEVICE_SELECTION_REQUIRED', 'A credential must be sent to one explicit Provider device');
156
+ if (!authorization)
157
+ return; // Existing v1 Providers keep their original flow.
158
+ validateAuthorization(authorization);
159
+ if (authorization.mode === 'bootstrap') {
160
+ remoteAssert(authorization.application_path === abilityPath, 'CONTRACT_INVALID', 'Bootstrap must identify its own authorization entry');
161
+ remoteAssert(!definitionId || authorization.application_definition_id === definitionId, 'CONTRACT_INVALID', 'Bootstrap definition does not match its authorization declaration');
162
+ return;
163
+ }
164
+ remoteAssert(authorization.credential_location === 'payload.credential' && authorization.encrypted === true, 'PROFILE_UNSUPPORTED', 'Unsupported credential transport profile');
165
+ remoteAssert(hasCredential, 'AUTHORIZATION_REQUIRED', 'Obtain a credential from the published authorization entry before calling', { provider_aid: provider, ability_path: abilityPath, authorization,
166
+ next_command: `ec ability remote info ${provider} ${authorization.application_path} --usage` });
167
+ remoteAssert(deviceId, 'DEVICE_SELECTION_REQUIRED', 'Credential calls require one explicit device from the Provider directory', { provider_aid: provider, ability_path: abilityPath, authorization });
124
168
  }
125
169
  ownedDiscovery(id, context, provider) {
126
170
  const found = this.store.get('discovery', id);
@@ -129,18 +173,25 @@ export class AbilityCallerService {
129
173
  return found;
130
174
  }
131
175
  async discovery(command, context, transport) {
176
+ const provider = command.provider;
132
177
  if (command.options.discovery)
133
- return this.ownedDiscovery(command.options.discovery, context, command.provider);
178
+ return this.ownedDiscovery(command.options.discovery, context, provider);
179
+ const currentKey = discoveryCurrentKey(context, provider);
134
180
  if (!command.options.refresh) {
135
- const cached = this.store.list('discovery', context.callerAid).filter(item => sameScope(item, context) && item.provider === command.provider && item.expiresAt > this.now())
181
+ const current = this.store.get('discovery-current', currentKey);
182
+ const latest = current && this.store.get('discovery', current.id);
183
+ if (latest && sameScope(latest, context) && latest.provider === provider && latest.expiresAt > this.now())
184
+ return latest;
185
+ const cached = this.store.list('discovery', context.callerAid).filter(item => sameScope(item, context) && item.provider === provider && item.expiresAt > this.now())
136
186
  .sort((a, b) => (b.source === 'online' ? 1 : 0) - (a.source === 'online' ? 1 : 0) || b.fetchedAt - a.fetchedAt)[0];
137
187
  if (cached)
138
188
  return cached;
139
189
  }
140
- const index = await this.readIndex(command.provider, transport);
141
- const snapshot = { ...context, id: `discovery-${randomUUID()}`, provider: command.provider, source: 'index', fetchedAt: this.now(), expiresAt: this.now() + 300_000,
190
+ const index = await this.readIndex(provider, transport);
191
+ const snapshot = { ...context, id: `discovery-${randomUUID()}`, provider, source: 'index', fetchedAt: this.now(), expiresAt: this.now() + 300_000,
142
192
  capabilities: index.capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
143
193
  this.store.put('discovery', snapshot.id, context.callerAid, snapshot);
194
+ this.store.put('discovery-current', currentKey, context.callerAid, { id: snapshot.id });
144
195
  return snapshot;
145
196
  }
146
197
  async readUsage(snapshot, reference, transport) {
@@ -178,12 +229,12 @@ export class AbilityCallerService {
178
229
  device_id: device, definition_id: row.definition_id, release_id: row.release_id, observed_at: snapshot.fetchedAt, evidence_source: snapshot.source,
179
230
  })));
180
231
  }
181
- discoveryView(snapshot, abilityPath, options = {}) {
232
+ discoveryView(snapshot, abilityPath, options = {}, hoistAuthorization = true) {
182
233
  const { capabilities: _capabilities, indexRef, ...directory } = snapshot.directory ?? {};
183
234
  const directoryFields = directory;
184
235
  const full = !!options.full;
185
- const metadata = full ? directory : Object.fromEntries(['schema', 'publisher', 'compatibility_schema', 'catalog_revision', 'updated_at', 'skill_ref']
186
- .filter(key => ['string', 'number'].includes(typeof directoryFields[key])).map(key => [key, directoryFields[key]]));
236
+ const metadata = full ? directory : Object.fromEntries(['schema', 'publisher', 'compatibility_schema', 'catalog_revision', 'updated_at', 'skill_ref', 'authorization', 'protocol_authorization']
237
+ .filter(key => directoryFields[key] !== undefined).map(key => [key, directoryFields[key]]));
187
238
  const search = options.search?.toLowerCase();
188
239
  const merged = new Map();
189
240
  for (const row of snapshot.capabilities) {
@@ -194,25 +245,45 @@ export class AbilityCallerService {
194
245
  }
195
246
  const rows = [...merged.values()].filter(row => (!abilityPath || row.path === abilityPath)
196
247
  && (!search || [row.path, row.name, row.summary, row.description].some(value => typeof value === 'string' && value.toLowerCase().includes(search))));
197
- const page = Number(options.page ?? 1), limit = Number(options.limit ?? 20);
198
- const start = (page - 1) * limit;
199
- const capabilities = rows.slice(start, start + limit).map(row => full ? row : {
200
- path: row.path, definition_id: row.definition_id,
201
- ...(typeof row.name === 'string' ? { name: row.name.slice(0, 80) } : {}),
202
- ...(typeof row.summary === 'string' || typeof row.description === 'string' ? { summary: String(row.summary ?? row.description).slice(0, 160) } : {}),
203
- device_count: row.devices?.length ?? 0,
204
- });
205
- const next = start + capabilities.length < rows.length ? page + 1 : null;
206
- const quote = (value) => `'${value.replaceAll("'", "'\\''")}'`;
207
- const nextCommand = next ? `ec ability remote list ${snapshot.provider}${abilityPath ? ` ${abilityPath}` : ''} --discovery ${snapshot.id} --page ${next} --limit ${limit}${full ? ' --full' : ''}${search ? ` --search ${quote(options.search)}` : ''}` : null;
248
+ // Hoist the most frequent repeated block across the snapshot, so filters
249
+ // do not change the meaning of authorization_variant.
250
+ const authorizations = new Map();
251
+ for (const row of hoistAuthorization ? merged.values() : []) {
252
+ if (!isJsonObject(row.authorization))
253
+ continue;
254
+ const key = canonicalizeAbilityJson(row.authorization);
255
+ const entry = authorizations.get(key);
256
+ if (entry)
257
+ entry.count++;
258
+ else
259
+ authorizations.set(key, { value: row.authorization, count: 1 });
260
+ }
261
+ let common;
262
+ for (const entry of authorizations.values())
263
+ if (entry.count > (common?.count ?? 1))
264
+ common = entry;
265
+ const commonKey = common ? canonicalizeAbilityJson(common.value) : undefined;
266
+ const capabilities = rows.map(({ authorization, ...row }) => ({
267
+ ...(full ? row : {
268
+ path: row.path, definition_id: row.definition_id,
269
+ ...(typeof row.name === 'string' ? { name: row.name.slice(0, 80) } : {}),
270
+ ...(typeof row.summary === 'string' || typeof row.description === 'string' ? { summary: String(row.summary ?? row.description).slice(0, 160) } : {}),
271
+ device_count: row.devices?.length ?? 0,
272
+ ...(options.devices ? { devices: row.devices } : {}),
273
+ }),
274
+ ...(authorization !== undefined && commonKey === canonicalizeAbilityJson(authorization)
275
+ ? { authorization_variant: 'shared' }
276
+ : authorization !== undefined ? { authorization } : {}),
277
+ }));
208
278
  return { subject_aid: snapshot.provider, provider_aid: snapshot.provider, discovery_id: snapshot.id, source: snapshot.source,
209
279
  ...(snapshot.directory ? { directory: metadata, ...(indexRef ? { index_ref: indexRef } : {}) } : {}),
210
280
  fetched_at: snapshot.fetchedAt, expires_at: snapshot.expiresAt, stale: snapshot.expiresAt <= this.now(),
211
281
  view: full ? 'full' : 'compact',
212
- pagination: { page, limit, total: rows.length, returned: capabilities.length, next_page: next, next_command: nextCommand },
282
+ ...(common ? { authorization: common.value } : {}),
283
+ total: capabilities.length,
213
284
  capabilities };
214
285
  }
215
- async discover(command, context, transport) {
286
+ async discover(command, context, transport, credential) {
216
287
  const provider = command.provider;
217
288
  let index = { capabilities: [] };
218
289
  try {
@@ -222,15 +293,25 @@ export class AbilityCallerService {
222
293
  if (!['OBJECT_NOT_FOUND', 'NOT_FOUND', 'ENOENT', 'FS_NOT_FOUND'].includes(error.code ?? ''))
223
294
  throw error;
224
295
  }
296
+ const protocol = isJsonObject(index.protocol_authorization) ? index.protocol_authorization : undefined;
297
+ const authorization = protocol && isJsonObject(protocol.authorization) ? protocol.authorization : undefined;
298
+ if (index.protocol_authorization !== undefined)
299
+ remoteAssert(protocol?.path === 'protocol/discover'
300
+ && typeof protocol.definition_id === 'string' && authorization, 'CONTRACT_INVALID', 'Invalid protocol authorization declaration');
301
+ const deviceId = command.options['device-id'];
302
+ this.checkAuthorization(authorization, !!credential, deviceId, 'protocol/discover', provider);
303
+ if (deviceId)
304
+ remoteAssert(index.capabilities.some(row => row.devices?.includes(deviceId)), 'DEVICE_NOT_DISCOVERED', 'Selected device is absent from the Provider directory');
225
305
  await transport.authorize(provider, 'send');
226
306
  const window = durationSeconds(command.options.window ?? '5s', 30);
227
307
  const requestId = `c-${randomUUID()}`, operationId = `op-${randomUUID()}`;
228
- const call = { ...context, provider, path: 'protocol/discover', requestId, operationId,
308
+ const call = { ...context, provider, path: 'protocol/discover', requestId, operationId, deviceId,
229
309
  fingerprint: digest([provider, 'protocol/discover', operationId]), sent: null, createdAt: this.now(), discoveryIndex: index };
230
310
  this.store.put('call', requestKey(context, requestId), context.callerAid, call);
231
311
  try {
232
312
  const sent = await transport.send(provider, { type: 'ability', role: 'call', call_id: requestId, operation_id: operationId,
233
- ability_path: 'protocol/discover', params: { spec_version: 'aid-ability/2', window_seconds: window }, ttl: window, async: false }, undefined, window * 1000);
313
+ ability_path: 'protocol/discover', params: { spec_version: 'aid-ability/2', window_seconds: window },
314
+ ...(credential ? { credential } : {}), ttl: window, async: false }, deviceId, window * 1000);
234
315
  call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
235
316
  if (!sent.ok)
236
317
  call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Discovery transport failed') };
@@ -256,14 +337,22 @@ export class AbilityCallerService {
256
337
  const capabilities = [];
257
338
  const devices = new Set();
258
339
  let invalid = 0;
259
- for (const item of record?.responses ?? []) {
340
+ const responses = record?.responses ?? (record?.responsePayload ? [{ responsePayload: record.responsePayload, responseDeviceId: record.responseDeviceId }] : []);
341
+ for (const item of responses) {
260
342
  try {
261
343
  const result = validateAbilityResult(item.responsePayload, { callId: call.requestId, operationId: call.operationId, abilityPath: call.path });
344
+ if (result.role === 'result' && result.ok === false && record?.targetDeviceId === item.responseDeviceId) {
345
+ return { ...response({ provider_aid: call.provider, request_id: call.requestId, device_id: item.responseDeviceId,
346
+ execution_state: result.execution_state, business_ok: false, result_validated: true,
347
+ provider_error: result.error }, false, 'BUSINESS_FAILED'), sent: call.sent };
348
+ }
262
349
  remoteAssert(result.role === 'result' && result.ok === true && isJsonObject(result.result), 'RESULT_INVALID', 'Invalid discovery result');
263
350
  const body = result.result;
264
- remoteAssert(isJsonObject(body.protocol) && body.protocol.spec_version === 'aid-ability/2' && Array.isArray(body.capabilities) && item.responseDeviceId, 'RESULT_INVALID', 'Unsupported discovery profile');
351
+ remoteAssert(isJsonObject(body.protocol) && body.protocol.spec_version === 'aid-ability/2' && Array.isArray(body.capabilities)
352
+ && item.responseDeviceId && (!call.deviceId || call.deviceId === item.responseDeviceId), 'RESULT_INVALID', 'Unsupported discovery profile or wrong device');
265
353
  boundedJson(body);
266
- const rows = body.capabilities.map(row => parseCapability(row, call.provider, [item.responseDeviceId]));
354
+ const responseDeviceId = item.responseDeviceId;
355
+ const rows = body.capabilities.map(row => parseCapability(row, call.provider, [responseDeviceId]));
267
356
  capabilities.push(...rows);
268
357
  devices.add(item.responseDeviceId);
269
358
  }
@@ -277,16 +366,18 @@ export class AbilityCallerService {
277
366
  source: 'online', fetchedAt: observedAt, expiresAt: observedAt + 60_000, capabilities, indexCapabilities: index.capabilities, skillRef: index.skill_ref, directory: index };
278
367
  if (devices.size && closed) {
279
368
  this.store.put('discovery', snapshot.id, context.callerAid, snapshot);
369
+ if (!call.discoveryId)
370
+ this.store.put('discovery-current', discoveryCurrentKey(context, call.provider), context.callerAid, { id: snapshot.id });
280
371
  call.discoveryId = snapshot.id;
281
372
  this.store.put('call', requestKey(context, call.requestId), context.callerAid, call);
282
373
  }
283
374
  const data = { ...this.discoveryView(snapshot, abilityPath, options), request_id: call.requestId, devices: [...devices], window_closed: closed,
284
- response_count: record?.responses?.length ?? 0, invalid_response_count: invalid, coverage: 'responding_devices_only' };
375
+ response_count: responses.length, invalid_response_count: invalid, coverage: 'responding_devices_only' };
285
376
  const code = invalid ? 'PARTIAL_RESULT' : devices.size && closed ? undefined : call.error?.code ?? (!devices.size ? 'NO_DISCOVERY_RESPONSE' : 'RESULT_PENDING');
286
377
  return { ...response(data, !code, code), sent: call.sent,
287
378
  ...(code ? { next_action: { command: `ec ability remote result ${call.requestId}`, resend_allowed: false } } : {}) };
288
379
  }
289
- async dispatch(plan, context, transport) {
380
+ async dispatch(plan, context, transport, credential) {
290
381
  await transport.authorize(plan.provider, 'send');
291
382
  const key = operationKey(context, plan.provider, plan.operationId);
292
383
  const existing = this.store.get('operation', key);
@@ -297,7 +388,12 @@ export class AbilityCallerService {
297
388
  }
298
389
  remoteAssert(plan.expiresAt > this.now(), 'PLAN_EXPIRED', 'Call plan or discovery evidence expired');
299
390
  this.ownedDiscovery(plan.discoveryId, context, plan.provider);
391
+ this.checkAuthorization(plan.authorization, !!credential, plan.deviceId, plan.path, plan.provider, plan.definition.definition_id);
300
392
  const call = { ...context, provider: plan.provider, path: plan.path, definition: plan.definition, deviceId: plan.deviceId,
393
+ ...(plan.authorization?.mode === 'bootstrap' && plan.authorization.application_path === plan.path
394
+ && plan.authorization.application_definition_id === plan.definition.definition_id ? { credentialIssuer: true } : {}),
395
+ credentialTargets: credentialTargetsFromParams(plan.params),
396
+ ...(typeof plan.params.application_id === 'string' ? { applicationId: plan.params.application_id } : {}),
301
397
  requestId: `c-${randomUUID()}`, operationId: plan.operationId, fingerprint: plan.fingerprint, sent: null, createdAt: this.now() };
302
398
  // Claim before the first await/send. A crash at any later point leaves an
303
399
  // unknown receipt which is queried, never automatically dispatched again.
@@ -308,7 +404,8 @@ export class AbilityCallerService {
308
404
  });
309
405
  try {
310
406
  const sent = await transport.send(call.provider, { type: 'ability', role: 'call', call_id: call.requestId, operation_id: call.operationId,
311
- ability_path: call.path, definition_id: plan.definition.definition_id, params: plan.params, ttl: plan.ttl, async: false }, call.deviceId, plan.timeout * 1000);
407
+ ability_path: call.path, definition_id: plan.definition.definition_id, params: plan.params,
408
+ ...(credential ? { credential } : {}), ttl: plan.ttl, async: false }, call.deviceId, plan.timeout * 1000);
312
409
  call.sent = sent.sent === false ? false : sent.sent === true || sent.message_id ? true : null;
313
410
  if (!sent.ok)
314
411
  call.error = { code: String(sent.code ?? 'TRANSPORT_FAILED'), message: String(sent.error ?? 'Transport failed') };
@@ -333,7 +430,7 @@ export class AbilityCallerService {
333
430
  if (call.path === 'protocol/discover')
334
431
  return this.discoveryResult(call, record, context);
335
432
  const data = { provider_aid: call.provider, ability_path: call.path, definition_id: call.definition?.definition_id,
336
- device_id: call.deviceId, call_id: call.requestId, operation_id: call.operationId, request_id: call.requestId,
433
+ device_id: call.deviceId ?? record?.responseDeviceId, call_id: call.requestId, operation_id: call.operationId, request_id: call.requestId,
337
434
  transport_state: record?.state ?? 'unknown', execution_state: 'unknown', business_ok: null,
338
435
  result_validated: false, ack_received: !!record?.ackMessageId, result: null,
339
436
  may_have_executed: call.sent !== false };
@@ -351,8 +448,50 @@ export class AbilityCallerService {
351
448
  remoteAssert(result.role === 'result', 'RESULT_INVALID', 'ACK is not a final result');
352
449
  if (result.ok)
353
450
  validateValue(call.definition.result_schema, result.result, 'RESULT_INVALID');
451
+ const credentialFiles = [];
452
+ const credentialErrors = [];
453
+ let approvedTargetsForApplication;
454
+ if (result.ok && isJsonObject(result.result)) {
455
+ const applicationId = typeof result.result.application_id === 'string' ? result.result.application_id : call.applicationId;
456
+ if (applicationId)
457
+ call.applicationId = applicationId;
458
+ const key = applicationId ? applicationKey(context, call.provider, applicationId) : undefined;
459
+ const previousTargets = key ? this.store.get('credential-application-requested', key) : undefined;
460
+ const targets = call.credentialTargets?.length ? call.credentialTargets : previousTargets ?? [];
461
+ if (key && targets.length && call.credentialTargets?.length)
462
+ this.store.put('credential-application-requested', key, context.callerAid, targets);
463
+ const approved = approvedCredentialTargets(result.result, targets, applicationId);
464
+ if (approved !== undefined) {
465
+ approvedTargetsForApplication = approved;
466
+ if (key)
467
+ this.store.put('credential-application', key, context.callerAid, approved);
468
+ }
469
+ }
470
+ if (result.ok && call.credentialIssuer && isJsonObject(result.result)
471
+ && result.result.storage_policy !== 'operation_only' && isJsonObject(result.result.credential)) {
472
+ const targets = approvedTargetsForApplication ?? (call.applicationId
473
+ ? this.store.get('credential-application', applicationKey(context, call.provider, call.applicationId)) ?? [] : []);
474
+ const savedPaths = new Set();
475
+ for (const target of targets) {
476
+ try {
477
+ const file = saveCredentialForTarget(context.callerAid, call.provider, target, result.result.credential);
478
+ if (savedPaths.has(file))
479
+ continue;
480
+ savedPaths.add(file);
481
+ credentialFiles.push({ ability_path: target.abilityPath, definition_id: target.definitionId, device_id: target.deviceId,
482
+ file });
483
+ }
484
+ catch {
485
+ credentialErrors.push({ ability_path: target.abilityPath, definition_id: target.definitionId, device_id: target.deviceId,
486
+ error: 'CREDENTIAL_FILE_WRITE_FAILED' });
487
+ }
488
+ }
489
+ }
354
490
  return { execution_state: result.execution_state, business_ok: result.ok, result_validated: true,
355
- result: result.ok ? result.result : null, ...(result.ok ? {} : { provider_error: result.error }) };
491
+ result: result.ok ? result.result : null,
492
+ ...(credentialFiles.length ? { credential_files: credentialFiles } : {}),
493
+ ...(credentialErrors.length ? { credential_file_errors: credentialErrors } : {}),
494
+ ...(result.ok ? {} : { provider_error: result.error }) };
356
495
  };
357
496
  try {
358
497
  if (record.responseMode === 'all_devices') {
@@ -368,7 +507,7 @@ export class AbilityCallerService {
368
507
  return { ...response({ ...data, results, collection_state: 'window_closed', coverage: 'responding_devices_only', business_ok: ok,
369
508
  result_validated: results.length > 0 && results.every(item => item.result_validated) }, ok, ok ? undefined : 'PARTIAL_RESULT'), sent: call.sent };
370
509
  }
371
- remoteAssert(record.responseDeviceId === call.deviceId, 'RESULT_INVALID', 'Result did not originate from the selected device');
510
+ remoteAssert(record.responseDeviceId && (!call.deviceId || record.responseDeviceId === call.deviceId), 'RESULT_INVALID', 'Result did not originate from the selected device or has no authenticated device identity');
372
511
  const result = validate(record.responsePayload);
373
512
  const code = result.business_ok ? undefined : result.execution_state === 'unknown' ? 'EXECUTION_UNKNOWN' : 'BUSINESS_FAILED';
374
513
  return { ...response({ ...data, ...result }, result.business_ok, code), sent: call.sent };