evolcore 0.0.49 → 0.0.51

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (514) hide show
  1. package/CHANGELOG.md +103 -3
  2. package/bin/ec-build.mjs +60 -0
  3. package/bin/ecmsg.js +64 -57
  4. package/dist/ability/caller/authorization.js +21 -0
  5. package/dist/ability/caller/command.js +173 -0
  6. package/dist/ability/caller/contract.js +117 -0
  7. package/dist/ability/caller/credential-files.js +132 -0
  8. package/dist/ability/caller/daemon.js +183 -0
  9. package/dist/ability/caller/schema-view.js +157 -0
  10. package/dist/ability/caller/service.js +519 -0
  11. package/dist/ability/command-contract.js +5 -0
  12. package/dist/ability/daemon.js +5 -1
  13. package/dist/ability/interop-v1.js +156 -106
  14. package/dist/ability/management.js +1 -0
  15. package/dist/agent-template/jobs.js +79 -3
  16. package/dist/agent-template/runtime.js +459 -47
  17. package/dist/agent-template/service.js +1242 -198
  18. package/dist/agent-template/share.js +103 -0
  19. package/dist/agent-template/tool-runner.js +25 -0
  20. package/dist/agent-template/types.js +10 -2
  21. package/dist/agents/claude/availability.js +94 -0
  22. package/dist/agents/claude/capability-provider.js +154 -0
  23. package/dist/agents/claude/index.js +145 -0
  24. package/dist/agents/{claude-runner.js → claude/runner.js} +78 -166
  25. package/dist/agents/claude/session-file-adapter.js +246 -0
  26. package/dist/agents/codex/app-server-client.js +90 -10
  27. package/dist/agents/codex/availability.js +164 -0
  28. package/dist/agents/codex/capability-provider.js +138 -0
  29. package/dist/agents/codex/cli.js +38 -0
  30. package/dist/agents/codex/index.js +345 -0
  31. package/dist/agents/codex/mcp-elicitation.js +135 -0
  32. package/dist/agents/{codex-runner.js → codex/runner.js} +652 -383
  33. package/dist/agents/codex/session-file-adapter.js +834 -0
  34. package/dist/agents/dsh/availability.js +28 -0
  35. package/dist/agents/dsh/capability-provider.js +56 -0
  36. package/dist/agents/dsh/desktop-locations.ps1 +66 -0
  37. package/dist/agents/dsh/desktop-probe.cjs +37 -0
  38. package/dist/agents/dsh/index.js +98 -0
  39. package/dist/agents/dsh/installation.js +400 -0
  40. package/dist/agents/dsh/resources.js +755 -0
  41. package/dist/agents/dsh/runner.js +1183 -0
  42. package/dist/agents/dsh/runtime/README.md +243 -0
  43. package/dist/agents/dsh/runtime/authorization.js +23 -0
  44. package/dist/agents/dsh/runtime/bridge.js +837 -0
  45. package/dist/agents/dsh/runtime/config.js +271 -0
  46. package/dist/agents/dsh/runtime/entry.js +229 -0
  47. package/dist/agents/dsh/runtime/session-inspector.js +340 -0
  48. package/dist/agents/dsh/runtime/tool-policy.js +49 -0
  49. package/dist/agents/dsh/session-file-adapter.js +145 -0
  50. package/dist/agents/ecagent/index.js +215 -0
  51. package/dist/agents/{ecagent-runner.js → ecagent/runner.js} +592 -106
  52. package/dist/agents/ecagent/session-file-adapter.js +134 -0
  53. package/dist/agents/gemini/index.js +96 -0
  54. package/dist/agents/{gemini-runner.js → gemini/runner.js} +18 -23
  55. package/dist/{core/session/adapters/gemini-session-file-adapter.js → agents/gemini/session-file-adapter.js} +2 -2
  56. package/dist/aun/ability-device-routing.js +11 -17
  57. package/dist/aun/aid/agentmd.js +27 -1
  58. package/dist/aun/aid/control-aid.js +52 -32
  59. package/dist/aun/aid/managed-operation.js +6 -4
  60. package/dist/aun/group/invite-service.js +7 -37
  61. package/dist/aun/group/operations.js +6 -0
  62. package/dist/aun/menu/client.js +1 -1
  63. package/dist/aun/msg/history.js +1 -1
  64. package/dist/aun/msg/managed-operation.js +93 -21
  65. package/dist/aun/msg/mention-schema.js +1 -1
  66. package/dist/aun/msg/p2p.js +32 -4
  67. package/dist/aun/msg/upload.js +126 -3
  68. package/dist/aun/service-proxy.js +1 -1
  69. package/dist/aun/storage/index.js +242 -0
  70. package/dist/build-identity.json +1 -1
  71. package/dist/channels/aun.js +698 -213
  72. package/dist/channels/daemon.js +3 -2
  73. package/dist/channels/dingtalk.js +1 -1
  74. package/dist/channels/feishu.js +9 -9
  75. package/dist/channels/qqbot.js +1 -1
  76. package/dist/channels/wechat.js +2 -2
  77. package/dist/channels/wecom.js +1 -1
  78. package/dist/claude-gateway/agent-registration.js +389 -0
  79. package/dist/claude-gateway/binding.js +96 -0
  80. package/dist/claude-gateway/inbox.js +138 -0
  81. package/dist/claude-gateway/index.js +125 -0
  82. package/dist/claude-gateway/listing.js +330 -0
  83. package/dist/claude-gateway/router.js +328 -0
  84. package/dist/claude-gateway/sessions.js +128 -0
  85. package/dist/claude-gateway/terminal.js +250 -0
  86. package/dist/claude-gateway/transcript.js +272 -0
  87. package/dist/claude-gateway/types.js +14 -0
  88. package/dist/cli/ability-command.js +45 -0
  89. package/dist/cli/ability-output.js +182 -0
  90. package/dist/cli/agent-command.js +21 -2
  91. package/dist/cli/agent-create.js +197 -56
  92. package/dist/cli/agent-template.js +400 -27
  93. package/dist/cli/agent.js +105 -11
  94. package/dist/cli/aun-commands.js +237 -123
  95. package/dist/cli/bench.js +5 -2
  96. package/dist/cli/config.js +22 -6
  97. package/dist/cli/daemon-commands.js +283 -109
  98. package/dist/cli/data-command.js +1 -1
  99. package/dist/cli/debug-mode.js +9 -0
  100. package/dist/cli/directory.js +1 -2
  101. package/dist/cli/ecmsg-gateway.js +64 -26
  102. package/dist/cli/fs-command.js +67 -39
  103. package/dist/cli/index.js +45 -12
  104. package/dist/cli/init.js +161 -90
  105. package/dist/cli/managed-command-guard.js +3 -0
  106. package/dist/cli/menu-client.js +32 -7
  107. package/dist/cli/model.js +1 -1
  108. package/dist/cli/pay-command.js +30 -0
  109. package/dist/cli/provider-command.js +6 -2
  110. package/dist/cli/restart-monitor.js +4 -4
  111. package/dist/cli/services-command.js +35 -10
  112. package/dist/cli/skill-command.js +4 -4
  113. package/dist/cli/task-context.js +24 -14
  114. package/dist/cli/team-workspace-command.js +50 -52
  115. package/dist/cli/thread-command.js +81 -14
  116. package/dist/cli/trigger-command.js +47 -12
  117. package/dist/cli/watch-logs.js +2 -1
  118. package/dist/config/access-policy.js +16 -3
  119. package/dist/config/boot-log.js +3 -0
  120. package/dist/config/builtin-role-templates.js +1 -1
  121. package/dist/config/config-field-policy.js +26 -13
  122. package/dist/config/config-manager.js +113 -52
  123. package/dist/config/config-operation-service.js +22 -1
  124. package/dist/config/gateway-config.js +29 -44
  125. package/dist/config/invoke-ipc-service.js +1 -1
  126. package/dist/config/owner-config.js +5 -19
  127. package/dist/config/peer-book-store.js +2 -3
  128. package/dist/config/peer-book.js +2 -2
  129. package/dist/config/peer-role-resolver.js +3 -9
  130. package/dist/config/provider-identity-migration.js +24 -105
  131. package/dist/config/provider-ipc-service.js +13 -3
  132. package/dist/config/provider-local-sync.js +4 -1
  133. package/dist/config/provider-menu-request.js +21 -3
  134. package/dist/config/provider-templates.js +1 -1
  135. package/dist/config/providers-config.js +138 -31
  136. package/dist/config/providers-import.js +3 -3
  137. package/dist/config/providers-management.js +109 -118
  138. package/dist/config/resolved-config-op.js +1 -42
  139. package/dist/config/schema-migration.js +254 -15
  140. package/dist/config/schema-registry.js +53 -8
  141. package/dist/config-store.js +1343 -63
  142. package/dist/core/{agent-application-service.js → agent/agent-application-service.js} +228 -9
  143. package/dist/core/{agent-create-status.js → agent/agent-create-status.js} +112 -4
  144. package/dist/core/{agent-creation-claim.js → agent/agent-creation-claim.js} +3 -3
  145. package/dist/core/{agent-ipc-registration.js → agent/agent-ipc-registration.js} +119 -25
  146. package/dist/core/{agent-reload-coordinator.js → agent/agent-reload-coordinator.js} +65 -0
  147. package/dist/core/{agent-runtime.js → agent/agent-runtime.js} +249 -79
  148. package/dist/core/{evolagent-registry.js → agent/evolagent-registry.js} +23 -18
  149. package/dist/core/{evolagent.js → agent/evolagent.js} +11 -11
  150. package/dist/core/auth/agent-delegation.js +15 -8
  151. package/dist/core/auth/delegation-authorization.js +28 -0
  152. package/dist/core/auth/operation-authorizer.js +20 -2
  153. package/dist/core/auth/operation-catalog.js +80 -8
  154. package/dist/core/baseagent/baseagent-availability.js +197 -0
  155. package/dist/core/baseagent/baseagent-capability-adapter.js +288 -0
  156. package/dist/core/baseagent/baseagent-config-shared.js +56 -0
  157. package/dist/core/baseagent/baseagent-identity.js +68 -0
  158. package/dist/core/{baseagent-loader.js → baseagent/baseagent-loader.js} +89 -6
  159. package/dist/core/baseagent/baseagent-model-defaults.js +26 -0
  160. package/dist/core/baseagent/baseagent-plugin-descriptor.js +357 -0
  161. package/dist/core/baseagent/baseagent-plugin-loader.js +367 -0
  162. package/dist/core/baseagent/baseagent.js +157 -0
  163. package/dist/{agents → core/baseagent}/runner-types.js +36 -4
  164. package/dist/core/capability/capability-manager.js +91 -33
  165. package/dist/core/capability/providers/claude-capability-provider.js +2 -154
  166. package/dist/core/capability/providers/codex-capability-provider.js +2 -136
  167. package/dist/core/{channel-loader.js → channel/channel-loader.js} +226 -38
  168. package/dist/core/{channel-runtime.js → channel/channel-runtime.js} +21 -19
  169. package/dist/core/command/agent-control.js +80 -17
  170. package/dist/core/command/agent-template-menu.js +23 -10
  171. package/dist/core/command/agentmd-menu-request.js +19 -8
  172. package/dist/core/command/agentmd-menu.js +14 -5
  173. package/dist/core/command/cli-intent-parser.js +15 -0
  174. package/dist/core/command/command-handler.js +127 -57
  175. package/dist/core/command/context-policy-menu.js +122 -0
  176. package/dist/core/command/data-root-resolver.js +157 -20
  177. package/dist/core/command/memory-slash.js +6 -6
  178. package/dist/core/command/menu-catalog.js +95 -19
  179. package/dist/core/command/menu-file-path.js +70 -0
  180. package/dist/core/command/menu-handler.js +392 -93
  181. package/dist/core/command/menu-protocol.js +47 -8
  182. package/dist/core/command/menu-query-batch.js +9 -5
  183. package/dist/core/command/private-mention-menu.js +71 -0
  184. package/dist/core/command/provider-menu.js +7 -11
  185. package/dist/core/command/role-menu.js +1 -1
  186. package/dist/core/command/skill-slash.js +17 -5
  187. package/dist/core/command/slash-gate.js +2 -4
  188. package/dist/core/command/slash-handler.js +143 -121
  189. package/dist/core/command/team-workspace-bootstrap.js +2 -1
  190. package/dist/core/command/team-workspace-team.js +3 -3
  191. package/dist/core/command/topic-slash.js +16 -10
  192. package/dist/core/{daemon-bootstrap.js → daemon/daemon-bootstrap.js} +14 -18
  193. package/dist/core/{daemon-control.js → daemon/daemon-control.js} +48 -21
  194. package/dist/core/{daemon-lifecycle.js → daemon/daemon-lifecycle.js} +28 -20
  195. package/dist/core/{host-snapshot.js → daemon/host-snapshot.js} +10 -5
  196. package/dist/core/{ipc-registration.js → daemon/ipc-registration.js} +101 -37
  197. package/dist/core/{lifecycle-notice.js → daemon/lifecycle-notice.js} +4 -5
  198. package/dist/core/file-integrity/store.js +1 -1
  199. package/dist/core/handoff/ipc-registration.js +3 -3
  200. package/dist/core/handoff/runtime.js +2 -2
  201. package/dist/{agents → core/inference}/request-identity.js +2 -2
  202. package/dist/core/inference/text-inference.js +4 -4
  203. package/dist/core/{bootstrap-messages.js → initialization/bootstrap-messages.js} +10 -10
  204. package/dist/core/{bootstrap-service.js → initialization/bootstrap-service.js} +24 -23
  205. package/dist/core/initialization/service.js +57 -9
  206. package/dist/core/invoke/executors/media.js +1 -1
  207. package/dist/core/invoke/executors/text.js +1 -1
  208. package/dist/core/memory/consolidation-context.js +3 -2
  209. package/dist/core/memory/consolidation-trigger.js +9 -3
  210. package/dist/core/memory/consolidation.js +39 -68
  211. package/dist/core/memory/memory-admin.js +6 -6
  212. package/dist/core/memory/memory-writer.js +1 -1
  213. package/dist/core/memory/relation-idle-monitor.js +1 -1
  214. package/dist/core/message/aun-ipc-sender.js +204 -88
  215. package/dist/core/message/aun-request-registry.js +44 -5
  216. package/dist/core/message/auto-mention-gate.js +1 -1
  217. package/dist/core/message/contact-admission.js +1 -1
  218. package/dist/core/message/im-renderer.js +19 -0
  219. package/dist/core/{interaction-router.js → message/interaction-router.js} +131 -1
  220. package/dist/core/message/items-formatter.js +5 -5
  221. package/dist/core/message/message-admission.js +1 -1
  222. package/dist/core/message/message-bridge.js +239 -59
  223. package/dist/core/message/message-log.js +8 -0
  224. package/dist/core/message/message-queue.js +88 -7
  225. package/dist/core/message/message-utils.js +1 -1
  226. package/dist/core/message/peer-mode.js +16 -5
  227. package/dist/core/message/response-engine.js +351 -152
  228. package/dist/core/message/send-options.js +44 -7
  229. package/dist/core/message/send-routing.js +55 -115
  230. package/dist/core/message/stream-idle-monitor.js +1 -1
  231. package/dist/core/{data-migration.js → migration/data-migration.js} +29 -1
  232. package/dist/core/model/catalog-service.js +29 -8
  233. package/dist/core/model/model-capabilities.js +88 -0
  234. package/dist/core/model/model-catalog.js +18 -7
  235. package/dist/core/model/model-diagnostics.js +4 -4
  236. package/dist/core/ownership/owner-resolver.js +107 -101
  237. package/dist/core/{pack-auth.js → pack/pack-auth.js} +34 -3
  238. package/dist/core/{pack-install.js → pack/pack-install.js} +95 -17
  239. package/dist/core/permission/approval-gateway.js +9 -18
  240. package/dist/core/permission/ec-command-parser.js +242 -82
  241. package/dist/core/permission/managed-file.js +234 -0
  242. package/dist/core/permission/protected-paths.js +120 -9
  243. package/dist/core/permission/sandbox-runtime.js +267 -3
  244. package/dist/core/permission/services-path-acl.js +9 -2
  245. package/dist/core/permission/session-path-grants.js +1 -1
  246. package/dist/core/permission/shell-environment.js +15 -1
  247. package/dist/core/permission/tool-policy.js +21 -9
  248. package/dist/core/plugin/plugin-lifecycle.js +442 -0
  249. package/dist/core/session/adapters/claude-session-file-adapter.js +2 -242
  250. package/dist/core/session/adapters/codex-session-file-adapter.js +2 -562
  251. package/dist/core/session/adapters/ecagent-session-file-adapter.js +2 -134
  252. package/dist/core/{background-session → session/background}/session-cleanup.js +2 -2
  253. package/dist/core/{background-session → session/background}/types.js +1 -1
  254. package/dist/core/session/session-file-health.js +2 -272
  255. package/dist/core/session/session-idle-monitor.js +1 -1
  256. package/dist/core/session/session-manager.js +76 -12
  257. package/dist/core/session/session-mapper.js +16 -0
  258. package/dist/core/session/session-terminal.js +185 -0
  259. package/dist/core/session/session-title.js +8 -11
  260. package/dist/core/{system-session → session/system}/memory.js +43 -9
  261. package/dist/core/{system-session → session/system}/registry.js +1 -1
  262. package/dist/core/{system-session → session/system}/types.js +1 -1
  263. package/dist/core/skill/index-generator.js +3 -3
  264. package/dist/core/skill/switch-resolver.js +3 -0
  265. package/dist/core/task/task-activity-store.js +112 -0
  266. package/dist/core/task/task-recovery-service.js +2 -2
  267. package/dist/core/thread/command-parser.js +4 -1
  268. package/dist/core/thread/ipc-operation.js +6 -4
  269. package/dist/core/thread/thread-operation.js +27 -11
  270. package/dist/core/thread/thread-route.js +5 -3
  271. package/dist/core/thread/thread-service.js +307 -58
  272. package/dist/core/thread/topic-id.js +52 -2
  273. package/dist/core/thread/types.js +15 -1
  274. package/dist/directory/{owner-directory-admission.js → admission.js} +3 -3
  275. package/dist/directory/{owner-directory-cache.js → cache.js} +90 -8
  276. package/dist/directory/{owner-directory-markdown.js → markdown.js} +2 -2
  277. package/dist/directory/{owner-directory-query-operation.js → query-operation.js} +83 -9
  278. package/dist/directory/{owner-directory-search.js → search.js} +50 -2
  279. package/dist/directory/{owner-directory-store.js → store.js} +2 -2
  280. package/dist/eck/kit-renderer.js +3 -2
  281. package/dist/eck/manifest-engine.js +64 -2
  282. package/dist/eck/message-renderer.js +35 -0
  283. package/dist/ecweb/basic-settings-service.js +12 -10
  284. package/dist/{contracts → ecweb/contracts}/ecweb-service-protocol.js +2 -1
  285. package/dist/ecweb/dsh-native-service.js +413 -0
  286. package/dist/ecweb/providers-service.js +5 -3
  287. package/dist/ecweb/runtime/lifecycle.js +1 -1
  288. package/dist/ecweb/runtime/supervisor.js +1 -1
  289. package/dist/event-center/center-config.js +2 -2
  290. package/dist/event-center/dispatcher.js +1 -1
  291. package/dist/event-center/ipc-operation.js +12 -3
  292. package/dist/event-center/pack-loader.js +2 -2
  293. package/dist/event-center/registry.js +6 -6
  294. package/dist/event-center/runtime.js +2 -2
  295. package/dist/index.js +181 -77
  296. package/dist/ipc.js +161 -12
  297. package/dist/outputs/authorization.js +27 -0
  298. package/dist/outputs/events.js +10 -1
  299. package/dist/outputs/panel-cards.js +960 -0
  300. package/dist/paths.js +60 -1
  301. package/dist/pay/command.js +38 -0
  302. package/dist/pay/protocol.js +136 -0
  303. package/dist/pay/runtime.js +196 -0
  304. package/dist/pay/service.js +384 -0
  305. package/dist/pay/store.js +81 -0
  306. package/dist/response-system/engines/v1/proactive-flow.js +30 -3
  307. package/dist/services/dispatcher.js +25 -7
  308. package/dist/services/host/main.js +397 -0
  309. package/dist/services/host/protocol.js +125 -0
  310. package/dist/services/host/resident.js +347 -0
  311. package/dist/services/host-client.js +398 -0
  312. package/dist/services/host-deploy.js +180 -0
  313. package/dist/services/host-launch.js +117 -0
  314. package/dist/services/host-recycle.js +208 -0
  315. package/dist/services/host-runtime.js +841 -0
  316. package/dist/services/idempotency.js +44 -86
  317. package/dist/services/index-generator.js +4 -3
  318. package/dist/services/index.js +258 -36
  319. package/dist/services/ipc-operation.js +503 -78
  320. package/dist/services/pack-manager.js +2 -2
  321. package/dist/services/router.js +43 -3
  322. package/dist/services/script-runner.js +541 -100
  323. package/dist/services/service-payload.js +28 -1
  324. package/dist/services/validation.js +136 -5
  325. package/dist/stats/context-usage.js +110 -0
  326. package/dist/stats/model-resolver.js +103 -17
  327. package/dist/stats/query.js +5 -0
  328. package/dist/trigger/application-service.js +9 -6
  329. package/dist/trigger/authorization.js +36 -33
  330. package/dist/trigger/ipc-service.js +4 -4
  331. package/dist/trigger/local-files.js +8 -166
  332. package/dist/trigger/manager.js +2 -2
  333. package/dist/trigger/parser.js +48 -0
  334. package/dist/trigger/scheduler.js +35 -13
  335. package/dist/trigger/script-executor.js +21 -0
  336. package/dist/trigger/script-sandbox.js +77 -232
  337. package/dist/trigger/system-definitions.js +25 -0
  338. package/dist/trigger/validation.js +1 -1
  339. package/dist/utils/aid-bind.js +3 -0
  340. package/dist/utils/atomic-write.js +88 -1
  341. package/dist/utils/cross-platform.js +4 -42
  342. package/dist/utils/error-dict.json +22 -1
  343. package/dist/utils/error-utils.js +193 -6
  344. package/dist/utils/evolcore-version.js +2 -2
  345. package/dist/utils/host-info.js +74 -1
  346. package/dist/utils/logger.js +5 -3
  347. package/dist/utils/media-cache.js +284 -42
  348. package/dist/utils/restart-safety.js +14 -1
  349. package/dist/utils/startup-trace.js +20 -4
  350. package/dist/utils/system-memory.js +113 -25
  351. package/dist/utils/systemd-lifecycle.js +154 -0
  352. package/dist/utils/welcome.js +64 -20
  353. package/dist/utils/windows-shell-trust.js +7 -3
  354. package/ecagent/README.md +35 -0
  355. package/ecagent/dist/agent-loop.js +80 -30
  356. package/ecagent/dist/harness/env/nodejs.d.ts +16 -0
  357. package/ecagent/dist/harness/env/nodejs.js +49 -20
  358. package/ecagent/dist/harness/messages.js +3 -2
  359. package/ecagent/dist/harness/types.d.ts +1 -0
  360. package/ecagent/dist/runtime/types.d.ts +2 -0
  361. package/ecagent/dist/runtime/utils/validation.d.ts +7 -1
  362. package/ecagent/dist/runtime/utils/validation.js +42 -0
  363. package/ecagent/dist/types.d.ts +2 -0
  364. package/kits/docs/INDEX.md +3 -2
  365. package/kits/docs/aun/AUN/346/266/210/346/201/257/347/261/273/345/236/213/344/270/216/345/261/236/346/200/247.md +1 -0
  366. package/kits/docs/channels/aun.md +1 -1
  367. package/kits/docs/channels/feishu.md +1 -1
  368. package/kits/docs/evolcore/INDEX.md +13 -9
  369. package/kits/docs/evolcore/agent-create.md +2 -0
  370. package/kits/docs/evolcore/agent.md +133 -11
  371. package/kits/docs/evolcore/aid.md +39 -6
  372. package/kits/docs/evolcore/config.md +95 -1
  373. package/kits/docs/evolcore/ctl.md +2 -1
  374. package/kits/docs/evolcore/ec-capabilities.md +7 -10
  375. package/kits/docs/evolcore/ecweb-lifecycle.md +5 -1
  376. package/kits/docs/evolcore/event.md +1 -1
  377. package/kits/docs/evolcore/fs.md +49 -3
  378. package/kits/docs/evolcore/group.md +5 -4
  379. package/kits/docs/evolcore/memory-consolidation.md +1 -1
  380. package/kits/docs/evolcore/memory-tags.md +2 -0
  381. package/kits/docs/evolcore/menu-client.md +3 -3
  382. package/kits/docs/evolcore/menu-protocol.md +31 -2
  383. package/kits/docs/evolcore/model.md +12 -1
  384. package/kits/docs/evolcore/msg.md +96 -36
  385. package/kits/docs/evolcore/pay.md +22 -0
  386. package/kits/docs/evolcore/plugin.md +74 -0
  387. package/kits/docs/evolcore/provider.md +29 -2
  388. package/kits/docs/evolcore/rpc.md +2 -2
  389. package/kits/docs/evolcore/services.md +46 -18
  390. package/kits/docs/evolcore/skill.md +17 -1
  391. package/kits/docs/evolcore/stats.md +5 -0
  392. package/kits/docs/evolcore/storage.md +22 -0
  393. package/kits/docs/evolcore/thread-chain.md +20 -9
  394. package/kits/docs/evolcore/tool-authorization.md +14 -0
  395. package/kits/docs/evolcore/trigger.md +89 -13
  396. package/kits/docs/identity/AID_PROFILE_SPEC.md +1 -1
  397. package/kits/docs/venues/feishu-group.md +3 -2
  398. package/kits/docs/venues/feishu-private.md +3 -2
  399. package/kits/rules/01-overview.md +11 -32
  400. package/kits/rules/02-navigation.md +20 -6
  401. package/kits/rules/06-channel.md +20 -4
  402. package/kits/schemas/_meta.json +42 -5
  403. package/kits/schemas/agent-config.schema.21.json +974 -0
  404. package/kits/schemas/agent-config.schema.22.json +977 -0
  405. package/kits/schemas/agent-config.schema.23.json +974 -0
  406. package/kits/schemas/agent-config.schema.24.json +986 -0
  407. package/kits/schemas/agent-config.schema.25.json +986 -0
  408. package/kits/schemas/daemon.schema.10.json +373 -0
  409. package/kits/schemas/daemon.schema.11.json +487 -0
  410. package/kits/schemas/daemon.schema.12.json +505 -0
  411. package/kits/schemas/daemon.schema.9.json +12 -0
  412. package/kits/schemas/defaults.schema.7.json +472 -0
  413. package/kits/schemas/defaults.schema.8.json +484 -0
  414. package/kits/schemas/providers.schema.1.json +1 -1
  415. package/kits/schemas/providers.schema.2.json +1 -1
  416. package/kits/schemas/providers.schema.3.json +26 -4
  417. package/kits/schemas/relation-config.schema.13.json +289 -0
  418. package/kits/skills/.switches.json +17 -1
  419. package/kits/skills/ability/SKILL.md +395 -33
  420. package/kits/skills/ability/STRUCTURE.md +338 -0
  421. package/kits/skills/ability/references/cli.md +208 -0
  422. package/kits/skills/ability/references/development.md +107 -37
  423. package/kits/skills/ability/references/management.md +106 -46
  424. package/kits/skills/ability/references/runtime-protocol.md +65 -63
  425. package/kits/skills/agent-output-cards/SKILL.md +80 -37
  426. package/kits/skills/agent-output-cards/examples/html-surface.json +11 -0
  427. package/kits/skills/agent-output-cards/examples/meeting-followups.json +16 -0
  428. package/kits/skills/agent-output-cards/examples/meeting-latest.json +24 -0
  429. package/kits/skills/agent-output-cards/examples/project-metrics.json +16 -0
  430. package/kits/skills/agent-output-cards/examples/quick-links.json +18 -0
  431. package/kits/skills/agent-output-cards/examples/surface.html +8 -0
  432. package/kits/skills/agent-template-project/SKILL.md +51 -0
  433. package/kits/skills/agent-template-project/references/01-collect-and-pack.md +174 -0
  434. package/kits/skills/agent-template-project/references/02-upload-and-share.md +109 -0
  435. package/kits/skills/agent-template-project/references/03-download-and-install.md +189 -0
  436. package/kits/skills/agent-template-project/references/04-upgrade-and-recovery.md +74 -0
  437. package/kits/skills/agent-template-project/references/05-publish-to-platform.md +62 -0
  438. package/kits/skills/ec-group/SKILL.md +8 -6
  439. package/kits/skills/ec-group/TASK.md +186 -0
  440. package/kits/skills/ec-group/WORKLOG.md +180 -0
  441. package/kits/skills/ec-group-collaboration/SKILL.md +5 -5
  442. package/kits/skills/ec-identity/SKILL.md +9 -6
  443. package/kits/skills/ec-pay/SKILL.md +223 -0
  444. package/kits/skills/ec-provider/SKILL.md +6 -6
  445. package/kits/skills/{ec-service-proxy → ec-proxy}/SKILL.md +8 -5
  446. package/kits/skills/ec-service-call/SKILL.md +138 -0
  447. package/kits/skills/ec-service-pack/SKILL.md +277 -0
  448. package/kits/skills/ec-skill/SKILL.md +25 -9
  449. package/kits/skills/ec-skill/scripts/cli.mjs +7 -7
  450. package/kits/skills/ec-skill/scripts/skill.mjs +55 -41
  451. package/kits/skills/ec-skill/scripts/template/SKILL.md.tmpl +9 -0
  452. package/kits/skills/ec-trigger/SKILL.md +3 -3
  453. package/kits/skills/personal-assistant/SKILL.md +22 -22
  454. package/kits/skills/personal-assistant/references/03-data-flow-and-gaps.md +1 -1
  455. package/kits/skills/scrapling-article-fetch/SKILL.md +5 -5
  456. package/kits/skills/thread-ops/SKILL.md +19 -9
  457. package/kits/skills/wechat-article-media-download/SKILL.md +2 -2
  458. package/kits/skills/wechat-article-reader/SKILL.md +2 -2
  459. package/kits/templates/memory-consolidation/notes.md +2 -2
  460. package/kits/templates/memory-consolidation/workflow.md +46 -0
  461. package/kits/templates/system-fragments/channel.md +13 -4
  462. package/kits/templates/system-fragments/commands.md +5 -4
  463. package/kits/templates/system-fragments/personal-assistant.md +2 -2
  464. package/kits/templates/system-fragments/reply.md +15 -9
  465. package/kits/templates/system-fragments/session.md +2 -2
  466. package/kits/templates/system-fragments/thread.md +30 -127
  467. package/kits/templates/system-fragments/venue.md +16 -0
  468. package/package.json +7 -7
  469. package/scripts/agent-template/index.mjs +7 -1
  470. package/scripts/agent-template/inspect.mjs +99 -39
  471. package/scripts/agent-template/overlay.mjs +126 -2
  472. package/scripts/agent-template/shared/common.mjs +49 -5
  473. package/scripts/agent-template/shared/plan.mjs +4 -2
  474. package/scripts/agent-template/shared/service-packs.mjs +104 -0
  475. package/scripts/agent-template/shared/team-schema.json +468 -39
  476. package/scripts/agent-template/shared/template-contract.mjs +93 -51
  477. package/scripts/agent-template/shared/template-package.mjs +225 -44
  478. package/scripts/agent-template/shared/template-runtime.mjs +137 -15
  479. package/scripts/agent-template/shared/template.mjs +31 -8
  480. package/scripts/agent-template/team-pack.mjs +528 -56
  481. package/scripts/agent-template/team-preview.mjs +102 -9
  482. package/scripts/aid-batch/identity-batch.mjs +1 -1
  483. package/dist/agents/baseagent-availability.js +0 -152
  484. package/dist/agents/baseagent.js +0 -750
  485. package/dist/agents/codex/catalog.js +0 -80
  486. package/dist/agents/ecagent-plugin-lazy.js +0 -41
  487. package/dist/agents/tool-time-context.js +0 -55
  488. package/dist/core/legacy-rename.js +0 -41
  489. package/dist/core/plugin-lifecycle.js +0 -137
  490. package/dist/core/rate-window.js +0 -53
  491. package/dist/core/runner-reload-transaction.js +0 -60
  492. package/dist/core/runtime-lock.js +0 -90
  493. package/dist/core/soul.js +0 -66
  494. package/dist/core/system-session/grants.js +0 -40
  495. package/dist/directory/owner-directory-agentmd-sync.js +0 -89
  496. package/dist/directory/owner-directory-request-operation.js +0 -79
  497. package/dist/directory/owner-directory-text.js +0 -60
  498. package/kits/docs/aun/ABILITY_CALLING.md +0 -280
  499. package/kits/docs/evolcore/ability.md +0 -185
  500. package/kits/skills/ability/references/calling.md +0 -56
  501. package/kits/skills/ability/references/contract-checklist.md +0 -37
  502. package/kits/skills/ability/references/recovery.md +0 -27
  503. /package/dist/{core/capability/providers/gemini-capability-provider.js → agents/gemini/capability-provider.js} +0 -0
  504. /package/dist/core/{system-channels.js → channel/system-channels.js} +0 -0
  505. /package/dist/core/{daemon-file-cache.js → daemon/daemon-file-cache.js} +0 -0
  506. /package/dist/core/{event-bus.js → event/event-bus.js} +0 -0
  507. /package/dist/core/{event-catalog.js → event/event-catalog.js} +0 -0
  508. /package/dist/core/{pack-ledger.js → pack/pack-ledger.js} +0 -0
  509. /package/dist/directory/{owner-directory-identity.js → identity.js} +0 -0
  510. /package/dist/directory/{owner-directory-policy.js → policy.js} +0 -0
  511. /package/dist/directory/{owner-directory-remarks.js → remarks.js} +0 -0
  512. /package/dist/directory/{owner-directory-scope.js → scope.js} +0 -0
  513. /package/dist/{contracts → ecweb/contracts}/ecweb-instance.js +0 -0
  514. /package/kits/templates/{bootstrap-welcome.md → bootstrap-intro.md} +0 -0
@@ -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
+ }