evolcore 0.0.50 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (448) hide show
  1. package/CHANGELOG.md +39 -2
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +65 -63
  4. package/dist/ability/caller/command.js +24 -15
  5. package/dist/ability/caller/contract.js +24 -9
  6. package/dist/ability/caller/credential-files.js +132 -0
  7. package/dist/ability/caller/daemon.js +32 -7
  8. package/dist/ability/caller/schema-view.js +157 -0
  9. package/dist/ability/caller/service.js +202 -63
  10. package/dist/ability/interop-v1.js +156 -113
  11. package/dist/agent-template/jobs.js +14 -110
  12. package/dist/agent-template/runtime.js +331 -193
  13. package/dist/agent-template/service.js +1029 -1104
  14. package/dist/agent-template/share.js +103 -0
  15. package/dist/agent-template/tool-runner.js +25 -0
  16. package/dist/agent-template/types.js +10 -3
  17. package/dist/agents/claude/availability.js +94 -0
  18. package/dist/agents/claude/capability-provider.js +154 -0
  19. package/dist/agents/claude/index.js +145 -0
  20. package/dist/agents/{claude-runner.js → claude/runner.js} +74 -158
  21. package/dist/agents/claude/session-file-adapter.js +246 -0
  22. package/dist/agents/codex/app-server-client.js +90 -10
  23. package/dist/agents/codex/availability.js +164 -0
  24. package/dist/agents/codex/capability-provider.js +138 -0
  25. package/dist/agents/codex/cli.js +38 -0
  26. package/dist/agents/codex/index.js +345 -0
  27. package/dist/agents/codex/mcp-elicitation.js +135 -0
  28. package/dist/agents/{codex-runner.js → codex/runner.js} +648 -382
  29. package/dist/agents/codex/session-file-adapter.js +834 -0
  30. package/dist/agents/dsh/availability.js +28 -0
  31. package/dist/agents/dsh/capability-provider.js +56 -0
  32. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  33. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  34. package/dist/agents/dsh/index.js +98 -0
  35. package/dist/agents/dsh/installation.js +400 -0
  36. package/dist/agents/dsh/resources.js +755 -0
  37. package/dist/agents/dsh/runner.js +1183 -0
  38. package/dist/agents/dsh/runtime/README.md +243 -0
  39. package/dist/agents/dsh/runtime/authorization.js +23 -0
  40. package/dist/agents/dsh/runtime/bridge.js +837 -0
  41. package/dist/agents/dsh/runtime/config.js +271 -0
  42. package/dist/agents/dsh/runtime/entry.js +229 -0
  43. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  44. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  45. package/dist/agents/dsh/session-file-adapter.js +145 -0
  46. package/dist/agents/ecagent/index.js +215 -0
  47. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  48. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  49. package/dist/agents/gemini/index.js +55 -10
  50. package/dist/agents/gemini/{gemini-runner.js → runner.js} +4 -9
  51. package/dist/aun/ability-device-routing.js +11 -17
  52. package/dist/aun/aid/agentmd.js +27 -1
  53. package/dist/aun/aid/managed-operation.js +6 -4
  54. package/dist/aun/group/invite-service.js +1 -1
  55. package/dist/aun/menu/client.js +1 -1
  56. package/dist/aun/msg/history.js +1 -1
  57. package/dist/aun/msg/managed-operation.js +93 -21
  58. package/dist/aun/msg/p2p.js +6 -6
  59. package/dist/aun/service-proxy.js +1 -1
  60. package/dist/aun/storage/index.js +242 -0
  61. package/dist/build-identity.json +1 -1
  62. package/dist/channels/aun.js +180 -43
  63. package/dist/channels/daemon.js +3 -2
  64. package/dist/channels/dingtalk.js +1 -1
  65. package/dist/channels/feishu.js +9 -9
  66. package/dist/channels/qqbot.js +1 -1
  67. package/dist/channels/wechat.js +2 -2
  68. package/dist/channels/wecom.js +1 -1
  69. package/dist/{agents/claude-gateway → claude-gateway}/agent-registration.js +13 -13
  70. package/dist/{agents/claude-gateway → claude-gateway}/binding.js +3 -3
  71. package/dist/{agents/claude-gateway → claude-gateway}/inbox.js +1 -1
  72. package/dist/{agents/claude-gateway → claude-gateway}/index.js +2 -2
  73. package/dist/{agents/claude-gateway → claude-gateway}/listing.js +3 -3
  74. package/dist/{agents/claude-gateway → claude-gateway}/router.js +4 -4
  75. package/dist/{agents/claude-gateway → claude-gateway}/sessions.js +2 -2
  76. package/dist/{agents/claude-gateway → claude-gateway}/terminal.js +1 -1
  77. package/dist/{agents/claude-gateway → claude-gateway}/transcript.js +1 -1
  78. package/dist/cli/ability-command.js +8 -5
  79. package/dist/cli/ability-output.js +182 -0
  80. package/dist/cli/agent-command.js +1 -1
  81. package/dist/cli/agent-create.js +123 -42
  82. package/dist/cli/agent-template.js +400 -29
  83. package/dist/cli/agent.js +14 -11
  84. package/dist/cli/aun-commands.js +167 -111
  85. package/dist/cli/daemon-commands.js +38 -8
  86. package/dist/cli/data-command.js +1 -1
  87. package/dist/cli/debug-mode.js +9 -0
  88. package/dist/cli/directory.js +1 -2
  89. package/dist/cli/ecmsg-gateway.js +55 -19
  90. package/dist/cli/fs-command.js +67 -39
  91. package/dist/cli/index.js +25 -11
  92. package/dist/cli/init.js +124 -29
  93. package/dist/cli/managed-command-guard.js +2 -0
  94. package/dist/cli/model.js +1 -1
  95. package/dist/cli/restart-monitor.js +2 -2
  96. package/dist/cli/services-command.js +24 -1
  97. package/dist/cli/skill-command.js +4 -4
  98. package/dist/cli/task-context.js +24 -14
  99. package/dist/cli/team-workspace-command.js +50 -52
  100. package/dist/cli/thread-command.js +3 -2
  101. package/dist/cli/trigger-command.js +47 -12
  102. package/dist/cli/watch-logs.js +2 -1
  103. package/dist/config/boot-log.js +3 -0
  104. package/dist/config/builtin-role-templates.js +1 -1
  105. package/dist/config/config-field-policy.js +10 -6
  106. package/dist/config/config-manager.js +33 -12
  107. package/dist/config/gateway-config.js +21 -37
  108. package/dist/config/invoke-ipc-service.js +1 -1
  109. package/dist/config/owner-config.js +5 -3
  110. package/dist/config/peer-book-store.js +2 -3
  111. package/dist/config/peer-book.js +2 -2
  112. package/dist/config/peer-role-resolver.js +2 -2
  113. package/dist/config/provider-identity-migration.js +24 -105
  114. package/dist/config/provider-ipc-service.js +13 -3
  115. package/dist/config/provider-local-sync.js +4 -1
  116. package/dist/config/provider-menu-request.js +21 -3
  117. package/dist/config/provider-templates.js +1 -1
  118. package/dist/config/providers-config.js +39 -15
  119. package/dist/config/providers-import.js +3 -3
  120. package/dist/config/providers-management.js +74 -99
  121. package/dist/config/schema-migration.js +177 -11
  122. package/dist/config/schema-registry.js +1 -1
  123. package/dist/config-store.js +38 -50
  124. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +9 -9
  125. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  126. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  127. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +102 -25
  128. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +61 -1
  129. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +53 -27
  130. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +12 -12
  131. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  132. package/dist/core/auth/agent-delegation.js +1 -8
  133. package/dist/core/auth/delegation-authorization.js +28 -0
  134. package/dist/core/auth/operation-authorizer.js +7 -4
  135. package/dist/core/auth/operation-catalog.js +34 -5
  136. package/dist/core/baseagent/baseagent-availability.js +197 -0
  137. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  138. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  139. package/dist/core/baseagent/baseagent-identity.js +68 -0
  140. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +62 -6
  141. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  142. package/dist/{agents → core/baseagent}/baseagent-plugin-descriptor.js +107 -24
  143. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  144. package/dist/core/baseagent/baseagent.js +157 -0
  145. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  146. package/dist/core/capability/capability-manager.js +79 -30
  147. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  148. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  149. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  150. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +18 -18
  151. package/dist/core/command/agent-control.js +60 -15
  152. package/dist/core/command/agent-template-menu.js +21 -9
  153. package/dist/core/command/agentmd-menu-request.js +19 -8
  154. package/dist/core/command/agentmd-menu.js +14 -5
  155. package/dist/core/command/command-handler.js +127 -57
  156. package/dist/core/command/context-policy-menu.js +122 -0
  157. package/dist/core/command/data-root-resolver.js +157 -20
  158. package/dist/core/command/memory-slash.js +6 -6
  159. package/dist/core/command/menu-catalog.js +80 -20
  160. package/dist/core/command/menu-handler.js +305 -25
  161. package/dist/core/command/menu-protocol.js +42 -8
  162. package/dist/core/command/menu-query-batch.js +9 -5
  163. package/dist/core/command/provider-menu.js +7 -11
  164. package/dist/core/command/role-menu.js +1 -1
  165. package/dist/core/command/skill-slash.js +17 -5
  166. package/dist/core/command/slash-gate.js +2 -4
  167. package/dist/core/command/slash-handler.js +127 -96
  168. package/dist/core/command/team-workspace-team.js +3 -3
  169. package/dist/core/command/topic-slash.js +10 -10
  170. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -14
  171. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +46 -20
  172. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +15 -15
  173. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +3 -3
  174. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +98 -38
  175. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  176. package/dist/core/file-integrity/store.js +1 -1
  177. package/dist/core/handoff/ipc-registration.js +3 -3
  178. package/dist/core/handoff/runtime.js +1 -1
  179. package/dist/{agents → core/inference}/request-identity.js +2 -2
  180. package/dist/core/inference/text-inference.js +4 -4
  181. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  182. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  183. package/dist/core/initialization/service.js +54 -9
  184. package/dist/core/invoke/executors/media.js +1 -1
  185. package/dist/core/invoke/executors/text.js +1 -1
  186. package/dist/core/memory/consolidation-context.js +1 -1
  187. package/dist/core/memory/consolidation-trigger.js +9 -3
  188. package/dist/core/memory/consolidation.js +4 -4
  189. package/dist/core/memory/memory-admin.js +6 -6
  190. package/dist/core/memory/memory-writer.js +1 -1
  191. package/dist/core/memory/relation-idle-monitor.js +1 -1
  192. package/dist/core/message/aun-ipc-sender.js +114 -75
  193. package/dist/core/message/aun-request-registry.js +13 -5
  194. package/dist/core/message/auto-mention-gate.js +1 -1
  195. package/dist/core/message/contact-admission.js +1 -1
  196. package/dist/core/message/im-renderer.js +19 -0
  197. package/dist/core/{interaction-router.js → message/interaction-router.js} +4 -4
  198. package/dist/core/message/items-formatter.js +5 -5
  199. package/dist/core/message/message-admission.js +1 -1
  200. package/dist/core/message/message-bridge.js +135 -54
  201. package/dist/core/message/message-queue.js +83 -4
  202. package/dist/core/message/message-utils.js +1 -1
  203. package/dist/core/message/peer-mode.js +1 -1
  204. package/dist/core/message/response-engine.js +347 -163
  205. package/dist/core/message/send-options.js +9 -6
  206. package/dist/core/message/send-routing.js +45 -109
  207. package/dist/core/message/stream-idle-monitor.js +1 -1
  208. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  209. package/dist/core/model/catalog-service.js +29 -8
  210. package/dist/core/model/model-capabilities.js +88 -0
  211. package/dist/core/model/model-catalog.js +14 -3
  212. package/dist/core/model/model-diagnostics.js +4 -4
  213. package/dist/core/ownership/owner-resolver.js +95 -15
  214. package/dist/core/{pack-auth.js → pack/pack-auth.js} +30 -3
  215. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  216. package/dist/core/permission/approval-gateway.js +9 -18
  217. package/dist/core/permission/ec-command-parser.js +70 -34
  218. package/dist/core/permission/managed-file.js +234 -0
  219. package/dist/core/permission/protected-paths.js +56 -0
  220. package/dist/core/permission/sandbox-runtime.js +267 -3
  221. package/dist/core/permission/session-path-grants.js +1 -1
  222. package/dist/core/permission/shell-environment.js +15 -1
  223. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  224. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -246
  225. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -566
  226. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  227. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  228. package/dist/core/{background-session → session/background}/types.js +1 -1
  229. package/dist/core/session/session-file-health.js +2 -272
  230. package/dist/core/session/session-idle-monitor.js +1 -1
  231. package/dist/core/session/session-manager.js +29 -2
  232. package/dist/core/session/session-terminal.js +185 -0
  233. package/dist/core/session/session-title.js +8 -11
  234. package/dist/core/{system-session → session/system}/memory.js +43 -9
  235. package/dist/core/{system-session → session/system}/registry.js +1 -1
  236. package/dist/core/{system-session → session/system}/types.js +1 -1
  237. package/dist/core/skill/index-generator.js +1 -0
  238. package/dist/core/task/task-activity-store.js +112 -0
  239. package/dist/core/task/task-recovery-service.js +2 -2
  240. package/dist/core/thread/ipc-operation.js +2 -2
  241. package/dist/core/thread/thread-operation.js +2 -1
  242. package/dist/core/thread/thread-route.js +5 -3
  243. package/dist/core/thread/thread-service.js +14 -4
  244. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  245. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  246. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  247. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  248. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  249. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  250. package/dist/eck/kit-renderer.js +1 -1
  251. package/dist/eck/manifest-engine.js +64 -2
  252. package/dist/eck/message-renderer.js +35 -0
  253. package/dist/ecweb/basic-settings-service.js +9 -3
  254. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  255. package/dist/ecweb/dsh-native-service.js +413 -0
  256. package/dist/ecweb/providers-service.js +1 -1
  257. package/dist/ecweb/runtime/lifecycle.js +1 -1
  258. package/dist/ecweb/runtime/supervisor.js +1 -1
  259. package/dist/event-center/center-config.js +2 -2
  260. package/dist/event-center/dispatcher.js +1 -1
  261. package/dist/event-center/ipc-operation.js +12 -3
  262. package/dist/event-center/pack-loader.js +2 -2
  263. package/dist/event-center/registry.js +6 -6
  264. package/dist/event-center/runtime.js +2 -2
  265. package/dist/index.js +71 -42
  266. package/dist/ipc.js +103 -10
  267. package/dist/outputs/authorization.js +27 -0
  268. package/dist/outputs/events.js +10 -1
  269. package/dist/outputs/panel-cards.js +960 -0
  270. package/dist/paths.js +12 -0
  271. package/dist/pay/command.js +1 -1
  272. package/dist/pay/runtime.js +18 -10
  273. package/dist/response-system/engines/v1/proactive-flow.js +1 -1
  274. package/dist/services/dispatcher.js +2 -2
  275. package/dist/services/host/main.js +10 -1
  276. package/dist/services/host/protocol.js +9 -2
  277. package/dist/services/host/resident.js +37 -0
  278. package/dist/services/host-client.js +12 -0
  279. package/dist/services/host-recycle.js +8 -3
  280. package/dist/services/host-runtime.js +54 -15
  281. package/dist/services/index.js +83 -19
  282. package/dist/services/ipc-operation.js +303 -38
  283. package/dist/services/pack-manager.js +2 -2
  284. package/dist/services/router.js +43 -3
  285. package/dist/services/script-runner.js +34 -25
  286. package/dist/services/service-payload.js +28 -1
  287. package/dist/services/validation.js +28 -2
  288. package/dist/stats/context-usage.js +110 -0
  289. package/dist/stats/model-resolver.js +103 -17
  290. package/dist/stats/query.js +5 -0
  291. package/dist/trigger/application-service.js +3 -2
  292. package/dist/trigger/authorization.js +36 -33
  293. package/dist/trigger/ipc-service.js +4 -4
  294. package/dist/trigger/local-files.js +8 -176
  295. package/dist/trigger/manager.js +2 -2
  296. package/dist/trigger/parser.js +48 -0
  297. package/dist/trigger/scheduler.js +14 -2
  298. package/dist/trigger/script-executor.js +21 -0
  299. package/dist/trigger/script-sandbox.js +57 -243
  300. package/dist/trigger/system-definitions.js +25 -0
  301. package/dist/trigger/validation.js +1 -1
  302. package/dist/utils/atomic-write.js +88 -1
  303. package/dist/utils/cross-platform.js +4 -42
  304. package/dist/utils/error-dict.json +22 -1
  305. package/dist/utils/error-utils.js +193 -6
  306. package/dist/utils/evolcore-version.js +2 -2
  307. package/dist/utils/host-info.js +1 -1
  308. package/dist/utils/logger.js +3 -1
  309. package/dist/utils/media-cache.js +99 -4
  310. package/dist/utils/startup-trace.js +20 -4
  311. package/dist/utils/welcome.js +64 -20
  312. package/ecagent/README.md +35 -0
  313. package/ecagent/dist/agent-loop.js +80 -30
  314. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  315. package/ecagent/dist/harness/env/nodejs.js +49 -20
  316. package/ecagent/dist/harness/messages.js +3 -2
  317. package/ecagent/dist/harness/types.d.ts +1 -0
  318. package/ecagent/dist/runtime/types.d.ts +2 -0
  319. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  320. package/ecagent/dist/runtime/utils/validation.js +42 -0
  321. package/ecagent/dist/types.d.ts +2 -0
  322. package/kits/docs/INDEX.md +1 -1
  323. package/kits/docs/channels/feishu.md +1 -1
  324. package/kits/docs/evolcore/INDEX.md +10 -7
  325. package/kits/docs/evolcore/agent-create.md +2 -0
  326. package/kits/docs/evolcore/agent.md +100 -13
  327. package/kits/docs/evolcore/aid.md +19 -3
  328. package/kits/docs/evolcore/config.md +94 -0
  329. package/kits/docs/evolcore/ctl.md +2 -1
  330. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  331. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  332. package/kits/docs/evolcore/event.md +1 -1
  333. package/kits/docs/evolcore/fs.md +49 -3
  334. package/kits/docs/evolcore/group.md +3 -3
  335. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  336. package/kits/docs/evolcore/menu-protocol.md +24 -2
  337. package/kits/docs/evolcore/model.md +9 -1
  338. package/kits/docs/evolcore/msg.md +30 -28
  339. package/kits/docs/evolcore/pay.md +8 -20
  340. package/kits/docs/evolcore/plugin.md +74 -0
  341. package/kits/docs/evolcore/provider.md +8 -2
  342. package/kits/docs/evolcore/rpc.md +2 -2
  343. package/kits/docs/evolcore/skill.md +17 -1
  344. package/kits/docs/evolcore/stats.md +5 -0
  345. package/kits/docs/evolcore/storage.md +22 -0
  346. package/kits/docs/evolcore/thread-chain.md +19 -10
  347. package/kits/docs/evolcore/tool-authorization.md +4 -0
  348. package/kits/docs/evolcore/trigger.md +89 -13
  349. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  350. package/kits/docs/venues/feishu-group.md +3 -2
  351. package/kits/docs/venues/feishu-private.md +3 -2
  352. package/kits/rules/02-navigation.md +20 -13
  353. package/kits/rules/06-channel.md +18 -2
  354. package/kits/schemas/_meta.json +8 -4
  355. package/kits/schemas/agent-config.schema.23.json +19 -3
  356. package/kits/schemas/agent-config.schema.24.json +986 -0
  357. package/kits/schemas/agent-config.schema.25.json +986 -0
  358. package/kits/schemas/daemon.schema.11.json +487 -0
  359. package/kits/schemas/daemon.schema.12.json +505 -0
  360. package/kits/schemas/defaults.schema.8.json +484 -0
  361. package/kits/schemas/providers.schema.1.json +1 -1
  362. package/kits/schemas/providers.schema.2.json +1 -1
  363. package/kits/schemas/providers.schema.3.json +8 -2
  364. package/kits/skills/.switches.json +4 -0
  365. package/kits/skills/ability/SKILL.md +194 -27
  366. package/kits/skills/ability/STRUCTURE.md +5 -0
  367. package/kits/skills/agent-output-cards/SKILL.md +90 -54
  368. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  369. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  370. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  371. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  372. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  373. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  374. package/kits/skills/agent-template-project/SKILL.md +51 -0
  375. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  376. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  377. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  378. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  379. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  380. package/kits/skills/ec-group/SKILL.md +3 -3
  381. package/kits/skills/ec-group-collaboration/SKILL.md +4 -4
  382. package/kits/skills/ec-identity/SKILL.md +9 -6
  383. package/kits/skills/ec-pay/SKILL.md +163 -41
  384. package/kits/skills/ec-provider/SKILL.md +5 -5
  385. package/kits/skills/ec-service-call/SKILL.md +3 -0
  386. package/kits/skills/ec-skill/SKILL.md +25 -9
  387. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  388. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  389. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  390. package/kits/skills/ec-trigger/SKILL.md +2 -2
  391. package/kits/skills/personal-assistant/SKILL.md +22 -22
  392. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  393. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  394. package/kits/skills/thread-ops/SKILL.md +19 -9
  395. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  396. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  397. package/kits/templates/system-fragments/commands.md +1 -1
  398. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  399. package/kits/templates/system-fragments/reply.md +14 -9
  400. package/kits/templates/system-fragments/session.md +1 -1
  401. package/kits/templates/system-fragments/thread.md +10 -5
  402. package/package.json +6 -5
  403. package/scripts/agent-template/index.mjs +7 -1
  404. package/scripts/agent-template/inspect.mjs +81 -35
  405. package/scripts/agent-template/overlay.mjs +110 -4
  406. package/scripts/agent-template/shared/common.mjs +36 -4
  407. package/scripts/agent-template/shared/plan.mjs +4 -2
  408. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  409. package/scripts/agent-template/shared/team-schema.json +467 -54
  410. package/scripts/agent-template/shared/template-contract.mjs +70 -68
  411. package/scripts/agent-template/shared/template-package.mjs +153 -36
  412. package/scripts/agent-template/shared/template-runtime.mjs +76 -64
  413. package/scripts/agent-template/shared/template.mjs +11 -46
  414. package/scripts/agent-template/team-pack.mjs +451 -35
  415. package/scripts/agent-template/team-preview.mjs +75 -226
  416. package/scripts/aid-batch/identity-batch.mjs +1 -1
  417. package/dist/agents/baseagent-availability.js +0 -176
  418. package/dist/agents/baseagent-capability-adapter.js +0 -102
  419. package/dist/agents/baseagent-plugin-loader.js +0 -145
  420. package/dist/agents/baseagent.js +0 -816
  421. package/dist/agents/codex/catalog.js +0 -80
  422. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  423. package/dist/agents/tool-time-context.js +0 -55
  424. package/dist/core/legacy-rename.js +0 -41
  425. package/dist/core/plugin-lifecycle.js +0 -137
  426. package/dist/core/rate-window.js +0 -53
  427. package/dist/core/runner-reload-transaction.js +0 -60
  428. package/dist/core/runtime-lock.js +0 -90
  429. package/dist/core/soul.js +0 -66
  430. package/dist/core/system-session/grants.js +0 -40
  431. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  432. package/dist/directory/owner-directory-request-operation.js +0 -79
  433. package/dist/directory/owner-directory-text.js +0 -60
  434. package/kits/skills/ec-pay/references/pay-cli.md +0 -110
  435. /package/dist/agents/gemini/{gemini-capability-provider.js → capability-provider.js} +0 -0
  436. /package/dist/agents/gemini/{gemini-session-file-adapter.js → session-file-adapter.js} +0 -0
  437. /package/dist/{agents/claude-gateway → claude-gateway}/types.js +0 -0
  438. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  439. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  440. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  441. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  442. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  443. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  444. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  445. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  446. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  447. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  448. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -0,0 +1,400 @@
1
+ import fs from 'node:fs';
2
+ import os from 'node:os';
3
+ import path from 'node:path';
4
+ import { getPackageRoot } from '../../paths.js';
5
+ import { createHash } from 'node:crypto';
6
+ import { execFileSync } from 'node:child_process';
7
+ import { createRequire } from 'node:module';
8
+ import { resolveProbePath } from '../../utils/cross-platform.js';
9
+ import { ConfigTarget, read, mutateConfig } from '../../config/config-manager.js';
10
+ import { ownerResolver, refreshOwnershipForAuthorization } from '../../core/ownership/owner-resolver.js';
11
+ import { DshNativeResourceRegistry } from './resources.js';
12
+ import { dshNativeSessionInspector } from './resources.js';
13
+ export const DSH_NATIVE_VERSION = '0.2.2-rc.5';
14
+ /** DSH always uses its registered native Home, Profile and session store. */
15
+ export function dshRuntimeMode(config) {
16
+ if (config.runtimeMode !== undefined && config.runtimeMode !== 'native-shared')
17
+ throw new Error('DSH_RUNTIME_MODE_INVALID');
18
+ if (typeof config.nativeResourceId !== 'string' || !/^dsh-resource-[a-f0-9]{64}$/.test(config.nativeResourceId)
19
+ || typeof config.nativeRegistrationRevision !== 'string'
20
+ || !/^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(config.nativeRegistrationRevision)) {
21
+ throw new Error('DSH_RESOURCE_NOT_REGISTERED');
22
+ }
23
+ if (['nodePath', 'packagePath'].some(key => config[key] !== undefined)) {
24
+ throw new Error('DSH_SHARED_SELECTION_OVERRIDE_UNAVAILABLE');
25
+ }
26
+ return 'native-shared';
27
+ }
28
+ export function dshIdentity(value) {
29
+ return createHash('sha256').update(JSON.stringify(value)).digest('hex');
30
+ }
31
+ function physicalFile(file) {
32
+ if (process.platform === 'win32' && !/^[a-z]:[\\/]$/i.test(path.parse(file).root))
33
+ throw new Error('DSH_INSTALLATION_PATH_INVALID: local drive paths are required');
34
+ if (!path.isAbsolute(file) || !fs.statSync(file).isFile())
35
+ throw new Error('DSH_INSTALLATION_PATH_INVALID');
36
+ return fs.realpathSync(file);
37
+ }
38
+ function stamp(file) {
39
+ const stat = fs.statSync(file, { bigint: true });
40
+ return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].join(':');
41
+ }
42
+ export function inspectDshDesktopInstallation(executablePath, source = ['explicit']) {
43
+ const executable = physicalFile(executablePath);
44
+ if (path.basename(executable).toLowerCase() !== 'deepseek harness.exe')
45
+ throw new Error('DSH_DESKTOP_EXECUTABLE_INVALID');
46
+ const archive = physicalFile(path.join(path.dirname(executable), 'resources', 'app.asar'));
47
+ const before = [stamp(executable), stamp(archive)];
48
+ const probePath = path.join(getPackageRoot(), 'dist', 'agents', 'dsh', 'desktop-probe.cjs');
49
+ let data;
50
+ try {
51
+ const output = execFileSync(executable, [probePath, executable], { encoding: 'utf8', windowsHide: true,
52
+ timeout: 8000, maxBuffer: 16 * 1024, cwd: path.dirname(executable),
53
+ env: { SystemRoot: process.env.SystemRoot, SYSTEMROOT: process.env.SystemRoot,
54
+ WINDIR: process.env.WINDIR, TEMP: process.env.TMPDIR, TMP: process.env.TMPDIR,
55
+ TMPDIR: process.env.TMPDIR, ELECTRON_RUN_AS_NODE: '1' }, stdio: ['ignore', 'pipe', 'pipe'] });
56
+ data = JSON.parse(output);
57
+ }
58
+ catch {
59
+ throw new Error('DSH_DESKTOP_PROBE_FAILED: unable to inspect the installed desktop runtime');
60
+ }
61
+ const after = [stamp(executable), stamp(archive)];
62
+ if (JSON.stringify(before) !== JSON.stringify(after))
63
+ throw new Error('DSH_INSTALLATION_CHANGED: retry discovery');
64
+ const expectedPackage = path.join(archive, 'dsh', 'node_modules', '@deepseek-ai', 'dsh', 'package.json');
65
+ if (!data || data.protocol !== 'evolcore-dsh-desktop-probe/1'
66
+ || data.executable !== executable || data.packagePath !== expectedPackage
67
+ || ['version', 'desktopVersion', 'nodeVersion', 'electronVersion', 'platform', 'arch'].some(key => typeof data[key] !== 'string' || data[key].length > 128)
68
+ || !Array.isArray(data.manifestHashes) || data.manifestHashes.length !== 2
69
+ || data.manifestHashes.some(value => typeof value !== 'string' || !/^[a-f0-9]{64}$/.test(value))) {
70
+ throw new Error('DSH_DESKTOP_PROBE_INVALID');
71
+ }
72
+ const nodeVersion = data.nodeVersion;
73
+ const [major, minor] = nodeVersion.split('.').map(Number);
74
+ const validNode = Number.isInteger(major) && (major > 24 || major === 24 && minor >= 9);
75
+ return { kind: 'desktop', installationId: 'dsh-install-' + dshIdentity(['desktop', executable.toLowerCase(), expectedPackage.toLowerCase()]),
76
+ revision: dshIdentity([after, data.manifestHashes]), executablePath: executable, packagePath: expectedPackage,
77
+ version: data.version, desktopVersion: data.desktopVersion, nodeVersion,
78
+ electronVersion: data.electronVersion, platform: data.platform, arch: data.arch,
79
+ compatible: data.version === DSH_NATIVE_VERSION && validNode && data.platform === process.platform && data.arch === process.arch,
80
+ source: [...new Set(source)].sort() };
81
+ }
82
+ function windowsLocations() {
83
+ try {
84
+ const executable = path.join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'WindowsPowerShell', 'v1.0', 'powershell.exe');
85
+ const script = path.join(getPackageRoot(), 'dist', 'agents', 'dsh', 'desktop-locations.ps1');
86
+ const output = execFileSync(executable, ['-NoProfile', '-NonInteractive', '-File', script], {
87
+ encoding: 'utf8', windowsHide: true, timeout: 10000, maxBuffer: 128 * 1024, stdio: ['ignore', 'pipe', 'pipe'],
88
+ env: { SystemRoot: process.env.SystemRoot, WINDIR: process.env.WINDIR,
89
+ APPDATA: process.env.APPDATA, ProgramData: process.env.ProgramData, USERPROFILE: process.env.USERPROFILE,
90
+ TEMP: process.env.TMPDIR, TMP: process.env.TMPDIR, TMPDIR: process.env.TMPDIR },
91
+ });
92
+ const data = JSON.parse(output.replace(/^\uFEFF/, ''));
93
+ if (!data || !Array.isArray(data.locations) || data.locations.length > 128 || !Array.isArray(data.failures)
94
+ || data.failures.length > 4 || data.locations.some((item) => !item || typeof item.executable !== 'string' || typeof item.source !== 'string')
95
+ || data.failures.some((item) => !item || typeof item.source !== 'string' || typeof item.reason !== 'string'))
96
+ throw new Error('Invalid discovery output');
97
+ return data;
98
+ }
99
+ catch {
100
+ return { locations: [], failures: [{ source: 'windows-discovery', reason: 'DSH_WINDOWS_DISCOVERY_FAILED' }] };
101
+ }
102
+ }
103
+ export function discoverDshDesktopInstallations(options = {}) {
104
+ const explicitPath = options.executablePath ?? process.env.DSH_DESKTOP_PATH;
105
+ const inventory = { installations: [], failures: [], explicit: explicitPath !== undefined };
106
+ if (process.platform !== 'win32') {
107
+ if (explicitPath !== undefined)
108
+ inventory.failures.push({ source: 'explicit', reason: 'DSH_DESKTOP_PLATFORM_UNSUPPORTED' });
109
+ return inventory;
110
+ }
111
+ const discovered = explicitPath === undefined ? windowsLocations() : { locations: [], failures: [] };
112
+ inventory.failures.push(...discovered.failures);
113
+ const candidates = explicitPath !== undefined ? [{ executable: explicitPath, source: 'explicit' }] : [
114
+ ...discovered.locations,
115
+ ...[process.env.LOCALAPPDATA, process.env.APPDATA].filter((value) => !!value)
116
+ .flatMap(directory => [path.join(directory, 'Programs', 'DeepSeekHarness'),
117
+ path.join(directory, 'Microsoft', 'Windows', 'Start Menu', 'Programs', 'DeepSeekHarness')])
118
+ .map(directory => ({ executable: path.join(directory, 'DeepSeek Harness.exe'), source: 'known-location' })),
119
+ ...[process.env.ProgramFiles, process.env['ProgramFiles(x86)']].filter((value) => !!value)
120
+ .map(directory => ({ executable: path.join(directory, 'DeepSeekHarness', 'DeepSeek Harness.exe'), source: 'known-location' })),
121
+ ];
122
+ const seen = new Map();
123
+ for (const candidate of candidates) {
124
+ if (!path.isAbsolute(candidate.executable) || path.extname(candidate.executable).toLowerCase() !== '.exe'
125
+ || !/^[a-z]:[\\/]$/i.test(path.parse(candidate.executable).root)) {
126
+ inventory.failures.push({ source: candidate.source, reason: 'DSH_DESKTOP_EXECUTABLE_INVALID' });
127
+ continue;
128
+ }
129
+ if (explicitPath === undefined && !fs.existsSync(candidate.executable))
130
+ continue;
131
+ try {
132
+ const canonical = physicalFile(candidate.executable);
133
+ const key = canonical.toLowerCase();
134
+ const prior = seen.get(key);
135
+ if (prior) {
136
+ prior.source = [...new Set([...prior.source, candidate.source])].sort();
137
+ continue;
138
+ }
139
+ const installation = inspectDshDesktopInstallation(canonical, [candidate.source]);
140
+ seen.set(key, installation);
141
+ inventory.installations.push(installation);
142
+ }
143
+ catch (error) {
144
+ inventory.failures.push({ source: candidate.source, reason: error instanceof Error ? error.message : 'DSH_DESKTOP_PROBE_FAILED' });
145
+ }
146
+ }
147
+ inventory.installations.sort((first, second) => first.installationId.localeCompare(second.installationId));
148
+ return inventory;
149
+ }
150
+ export function selectDshDesktopInstallation(inventory, installationId) {
151
+ if (inventory.explicit && inventory.failures.length)
152
+ throw new Error(inventory.failures[0].reason);
153
+ if (installationId === undefined && inventory.failures.length)
154
+ throw new Error('DSH_INSTALLATION_DISCOVERY_INCOMPLETE: resolve discovery failures before automatic selection');
155
+ const matches = installationId === undefined ? inventory.installations.filter(installation => installation.compatible)
156
+ : inventory.installations.filter(installation => installation.installationId === installationId);
157
+ if (matches.length === 0)
158
+ throw new Error(installationId === undefined
159
+ ? inventory.installations.length ? 'DSH_VERSION_UNSUPPORTED: no compatible native runtime' : 'DSH_INSTALLATION_NOT_FOUND'
160
+ : 'DSH_INSTALLATION_CHANGED: bound installation is absent');
161
+ if (matches.length !== 1)
162
+ throw new Error('DSH_INSTALLATION_AMBIGUOUS: select an installation explicitly');
163
+ if (!matches[0].compatible)
164
+ throw new Error('DSH_VERSION_UNSUPPORTED: native runtime is incompatible');
165
+ return matches[0];
166
+ }
167
+ export function revalidateDshDesktopInstallation(installation) {
168
+ const current = inspectDshDesktopInstallation(installation.executablePath, installation.source);
169
+ if (current.installationId !== installation.installationId || current.revision !== installation.revision) {
170
+ throw new Error('DSH_INSTALLATION_CHANGED: rediscovery and confirmation are required');
171
+ }
172
+ if (!current.compatible)
173
+ throw new Error('DSH_VERSION_UNSUPPORTED: native runtime is incompatible');
174
+ return current;
175
+ }
176
+ export function probeDshDesktopInventory() {
177
+ const inventory = discoverDshDesktopInstallations();
178
+ if (!inventory.installations.length && !inventory.explicit && !inventory.failures.length)
179
+ return undefined;
180
+ const single = inventory.installations.length === 1 ? inventory.installations[0] : undefined;
181
+ const compatible = inventory.installations.some(installation => installation.compatible) && inventory.failures.length === 0;
182
+ // Discovery admits the adapter, not any Agent's resource access. The factory
183
+ // separately requires explicit, current consent for the selected installation.
184
+ return { available: compatible, installed: inventory.installations.length > 0,
185
+ compatible,
186
+ version: single?.version, installationPath: single?.packagePath,
187
+ reason: inventory.failures.length ? inventory.failures[0].reason
188
+ : !inventory.installations.length ? 'DSH_INSTALLATION_NOT_FOUND'
189
+ : !single ? 'DSH_NATIVE_RESOURCE_SELECTION_REQUIRED: confirm the compatible installation during host BaseAgent admission'
190
+ : !single.compatible ? 'DSH_VERSION_UNSUPPORTED: installed desktop runtime is incompatible'
191
+ : 'DSH_NATIVE_RESOURCE_SELECTION_REQUIRED: confirm host resources; desktop sharing is preferred' };
192
+ }
193
+ export function resolveDshPackagePath(config) {
194
+ let packagePath = config.packagePath ?? process.env.DSH_PACKAGE_PATH;
195
+ if (!packagePath) {
196
+ try {
197
+ packagePath = createRequire(import.meta.url).resolve('@deepseek-ai/dsh/package.json');
198
+ }
199
+ catch {
200
+ const cli = resolveProbePath('dsh');
201
+ if (cli) {
202
+ packagePath = /\.(cmd|bat|ps1)$/i.test(cli)
203
+ ? path.join(path.dirname(cli), 'node_modules', '@deepseek-ai', 'dsh', 'package.json')
204
+ : path.join(path.dirname(fs.realpathSync(cli)), '..', 'package.json');
205
+ }
206
+ }
207
+ }
208
+ if (typeof packagePath !== 'string' || !path.isAbsolute(packagePath)) {
209
+ throw new Error('DSH_PACKAGE_PATH must identify the installed @deepseek-ai/dsh/package.json');
210
+ }
211
+ return packagePath;
212
+ }
213
+ /** Resolve a pinned installation without invoking its CLI or reading user credentials. */
214
+ export function inspectDshInstallation(config = {}) {
215
+ const packagePath = resolveDshPackagePath(config);
216
+ const manifest = JSON.parse(fs.readFileSync(packagePath, 'utf8'));
217
+ if (manifest.name !== '@deepseek-ai/dsh' || manifest.version !== DSH_NATIVE_VERSION) {
218
+ throw new Error(`DSH requires @deepseek-ai/dsh ${DSH_NATIVE_VERSION}`);
219
+ }
220
+ const binPath = path.resolve(path.dirname(packagePath), manifest.bin?.dsh ?? 'lib/bin.js');
221
+ if (!fs.statSync(binPath).isFile())
222
+ throw new Error('DSH built CLI entry is missing');
223
+ const explicitNode = config.nodePath ?? process.env.DSH_NODE_PATH;
224
+ // nvm's global package lives under <prefix>/lib/node_modules; Windows npm
225
+ // prefixes use <prefix>/node_modules. Prefer that installation's own Node.
226
+ const prefix = path.resolve(path.dirname(packagePath), '..', '..', '..');
227
+ const candidates = explicitNode !== undefined ? [String(explicitNode)] : [...new Set([
228
+ path.basename(prefix) === 'lib' ? path.join(path.dirname(prefix), 'bin', 'node') : path.join(prefix, 'node.exe'),
229
+ resolveProbePath('node'), process.execPath,
230
+ ].filter((value) => !!value))];
231
+ const failures = [];
232
+ for (const nodePath of candidates) {
233
+ if (explicitNode === undefined && !fs.existsSync(nodePath))
234
+ continue;
235
+ try {
236
+ const nodeVersion = execFileSync(nodePath, ['--version'], { encoding: 'utf8', timeout: 5000, windowsHide: true }).trim();
237
+ const [major, minor] = nodeVersion.replace(/^v/, '').split('.').map(Number);
238
+ if (Number.isInteger(major) && (major > 24 || (major === 24 && minor >= 9))) {
239
+ return { nodePath, packagePath, binPath, version: manifest.version };
240
+ }
241
+ failures.push(nodeVersion);
242
+ }
243
+ catch (error) {
244
+ failures.push(error instanceof Error ? error.message : String(error));
245
+ }
246
+ }
247
+ throw new Error(`DSH requires Node >=24.9; detected ${failures.join('; ') || 'no executable'}`);
248
+ }
249
+ function inspectCli(executablePath, packagePath) {
250
+ const executable = fs.realpathSync(executablePath);
251
+ const manifestPath = fs.realpathSync(packagePath);
252
+ const manifestBytes = fs.readFileSync(manifestPath);
253
+ const manifest = JSON.parse(manifestBytes.toString('utf8'));
254
+ if (manifest.name !== '@deepseek-ai/dsh' || manifest.version !== DSH_NATIVE_VERSION)
255
+ throw new Error('DSH_VERSION_UNSUPPORTED');
256
+ const launcher = fs.realpathSync(path.resolve(path.dirname(manifestPath), manifest.bin?.dsh ?? 'lib/bin.js'));
257
+ const stamps = [executable, manifestPath, launcher].map(file => {
258
+ const stat = fs.statSync(file, { bigint: true });
259
+ if (!stat.isFile())
260
+ throw new Error('DSH_INSTALLATION_PATH_INVALID');
261
+ return [stat.dev, stat.ino, stat.size, stat.mtimeNs, stat.ctimeNs].map(String);
262
+ });
263
+ return { kind: 'cli', installationId: 'dsh-install-' + dshIdentity(['cli', executable, manifestPath]),
264
+ revision: dshIdentity([stamps, manifestBytes.toString('base64')]), executablePath: executable,
265
+ packagePath: manifestPath, version: DSH_NATIVE_VERSION, compatible: true, source: ['cli'] };
266
+ }
267
+ /** Both desktop and CLI installations use their existing native data. */
268
+ export function discoverDshNativeInstallations() {
269
+ const desktop = discoverDshDesktopInstallations();
270
+ if (desktop.installations.length || desktop.failures.length || desktop.explicit)
271
+ return desktop;
272
+ if (!['win32', 'linux'].includes(process.platform)) {
273
+ return { installations: [], failures: [{ source: 'platform', reason: 'DSH_INSTALLATION_PLATFORM_UNSUPPORTED' }], explicit: false };
274
+ }
275
+ try {
276
+ const cli = inspectDshInstallation();
277
+ return { installations: [inspectCli(cli.nodePath, cli.packagePath)], failures: [], explicit: process.env.DSH_PACKAGE_PATH !== undefined };
278
+ }
279
+ catch (error) {
280
+ return { installations: [], failures: [{ source: 'cli', reason: error instanceof Error ? error.message : String(error) }],
281
+ explicit: process.env.DSH_PACKAGE_PATH !== undefined };
282
+ }
283
+ }
284
+ export function chooseDshNativeInstallation(installationId) {
285
+ const inventory = discoverDshNativeInstallations();
286
+ if (inventory.explicit && inventory.failures.length)
287
+ throw new Error(inventory.failures[0].reason);
288
+ if (installationId === undefined && inventory.failures.length)
289
+ throw new Error('DSH_INSTALLATION_DISCOVERY_INCOMPLETE');
290
+ const matches = inventory.installations.filter(item => installationId === undefined ? item.compatible : item.installationId === installationId);
291
+ if (!matches.length)
292
+ throw new Error(installationId ? 'DSH_INSTALLATION_CHANGED' : 'DSH_INSTALLATION_NOT_FOUND');
293
+ if (matches.length !== 1)
294
+ throw new Error('DSH_INSTALLATION_AMBIGUOUS');
295
+ if (!matches[0].compatible)
296
+ throw new Error('DSH_VERSION_UNSUPPORTED');
297
+ return matches[0];
298
+ }
299
+ export async function selectDshNativeInstallation(installationId) {
300
+ if (!/^dsh-install-[a-f0-9]{64}$/.test(installationId))
301
+ throw new Error('DSH_INSTALLATION_PATH_INVALID');
302
+ return chooseDshNativeInstallation(installationId);
303
+ }
304
+ export function revalidateDshNativeInstallation(snapshot) {
305
+ if (snapshot.kind === 'desktop')
306
+ return revalidateDshDesktopInstallation(snapshot);
307
+ if (snapshot.kind !== 'cli' || !['linux', 'win32'].includes(process.platform))
308
+ throw new Error('DSH_INSTALLATION_PLATFORM_UNSUPPORTED');
309
+ const current = inspectCli(snapshot.executablePath, snapshot.packagePath);
310
+ if (current.installationId !== snapshot.installationId || current.revision !== snapshot.revision)
311
+ throw new Error('DSH_INSTALLATION_CHANGED');
312
+ return current;
313
+ }
314
+ export function validateDshHostSetup(value) {
315
+ if (!value || typeof value !== 'object' || Array.isArray(value))
316
+ return false;
317
+ const input = value;
318
+ return Object.keys(input).every(key => ['runtimeMode', 'installationId', 'homePath', 'profilePath'].includes(key))
319
+ && (input.runtimeMode === undefined || input.runtimeMode === 'native-shared')
320
+ && ['installationId', 'homePath', 'profilePath'].every(key => input[key] === undefined
321
+ || typeof input[key] === 'string' && input[key].length > 0 && input[key].length <= 4096);
322
+ }
323
+ /** Only called from the authorized process plugin-management boundary. */
324
+ async function hostAuthority(principalId) {
325
+ await refreshOwnershipForAuthorization(undefined, { includeDaemon: true, allowTransient: false });
326
+ const daemonAid = ownerResolver.getDaemonAid();
327
+ const owners = ownerResolver.daemonOwners();
328
+ const owner = principalId ?? (owners.length === 1 ? owners[0] : undefined);
329
+ if (!daemonAid || !owner || !ownerResolver.isOwner(daemonAid, owner))
330
+ throw new Error('DSH_RESOURCE_OWNER_REQUIRED');
331
+ return { daemonAid, subject: {
332
+ allowAccess: true, chatType: 'private', channelType: 'aun', actorId: owner, principalId: owner,
333
+ processRole: 'daemon-owner', isDaemonOwner: true, ecwebManagement: true,
334
+ } };
335
+ }
336
+ export function dshNativeHomePath() {
337
+ return path.resolve(process.env.DSH_HOME || path.join(os.homedir(), '.dsh'));
338
+ }
339
+ export function dshNativeProfilePath(homePath, kind) {
340
+ const profiles = path.join(homePath, 'profiles');
341
+ const preferred = path.join(profiles, kind === 'desktop' ? 'desktop' : 'default');
342
+ if (fs.existsSync(path.join(preferred, 'package.json')))
343
+ return preferred;
344
+ let candidates = [];
345
+ try {
346
+ candidates = fs.readdirSync(profiles, { withFileTypes: true })
347
+ .filter(entry => entry.isDirectory() && fs.existsSync(path.join(profiles, entry.name, 'package.json')))
348
+ .map(entry => path.join(profiles, entry.name));
349
+ }
350
+ catch (error) {
351
+ if (error.code !== 'ENOENT')
352
+ throw error;
353
+ }
354
+ if (candidates.length === 1)
355
+ return candidates[0];
356
+ if (candidates.length > 1)
357
+ throw new Error('DSH_PROFILE_SELECTION_REQUIRED');
358
+ return preferred;
359
+ }
360
+ /** Select native resources at host admission, without creating another Home. */
361
+ export function selectDshHostSetup(input) {
362
+ if (input !== undefined && !validateDshHostSetup(input))
363
+ throw new Error('DSH_HOST_SETUP_INVALID');
364
+ const installation = chooseDshNativeInstallation(input?.installationId);
365
+ const homePath = input?.homePath ?? dshNativeHomePath();
366
+ return { runtimeMode: 'native-shared', installationId: installation.installationId,
367
+ homePath, profilePath: input?.profilePath ?? dshNativeProfilePath(homePath, installation.kind) };
368
+ }
369
+ export async function configureDshHost(input, principalId) {
370
+ const previous = read(ConfigTarget.Defaults, undefined, { cache: false })?.baseagents?.dsh ?? {};
371
+ const registry = new DshNativeResourceRegistry();
372
+ if (input === undefined && previous.runtimeMode === 'native-shared') {
373
+ const { daemonAid } = await hostAuthority(principalId);
374
+ dshRuntimeMode(previous);
375
+ const grant = await registry.resolve(daemonAid, previous.nativeResourceId, previous.nativeRegistrationRevision);
376
+ if (grant.scope !== 'host')
377
+ throw new Error('DSH_HOST_SETUP_REQUIRED');
378
+ return previous;
379
+ }
380
+ const selection = selectDshHostSetup(input);
381
+ const { daemonAid, subject } = await hostAuthority(principalId);
382
+ const preview = await registry.preview(subject, daemonAid, {
383
+ installationId: selection.installationId, homePath: selection.homePath, profilePath: selection.profilePath,
384
+ });
385
+ await dshNativeSessionInspector.profile(preview);
386
+ const existing = (await registry.inspect(subject, daemonAid)).resources.find(entry => entry.scope === 'host'
387
+ && entry.resource.revision === preview.resource.revision && entry.installation.revision === preview.installation.revision
388
+ && entry.resource.nativeResourceId === preview.resource.nativeResourceId && entry.ownerAid === subject.principalId
389
+ && entry.daemonOwnershipVersion === ownerResolver.snapshot(daemonAid).consensus?.relation_version);
390
+ const grant = existing ?? await registry.register(subject, daemonAid, { ...preview,
391
+ expectedRegistryRevision: preview.registryRevision, sharingConsent: 'native-resources', scope: 'host' });
392
+ const config = { ...previous, runtimeMode: 'native-shared',
393
+ nativeResourceId: grant.resource.nativeResourceId, nativeRegistrationRevision: grant.revision };
394
+ mutateConfig(ConfigTarget.Defaults, undefined, defaults => {
395
+ if (JSON.stringify(defaults.baseagents?.dsh ?? {}) !== JSON.stringify(previous))
396
+ throw new Error('DSH_HOST_SETUP_CONFLICT');
397
+ defaults.baseagents = { ...defaults.baseagents, dsh: config };
398
+ });
399
+ return config;
400
+ }