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,755 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { spawn } from 'node:child_process';
4
+ import { randomUUID, randomBytes } from 'node:crypto';
5
+ import { resolveRoot } from '../../paths.js';
6
+ import { getPackageRoot } from '../../paths.js';
7
+ import { assertOwnershipAuthorization } from '../../core/ownership/owner-resolver.js';
8
+ import { isValidAid } from '../../aun/aid/validation.js';
9
+ import { ownerResolver, refreshOwnershipForAuthorization } from '../../core/ownership/owner-resolver.js';
10
+ import { queryRecord, registerContent, verifyFile } from '../../core/file-integrity/store.js';
11
+ import { atomicReplaceJson, withFileLock } from '../../utils/atomic-write.js';
12
+ import { dshIdentity } from './installation.js';
13
+ import { selectDshNativeInstallation, revalidateDshNativeInstallation } from './installation.js';
14
+ async function inspectNativeSession(registration, projectPath, selection, signal) {
15
+ signal?.throwIfAborted();
16
+ const temporary = process.env.TMPDIR;
17
+ if (!temporary || !path.isAbsolute(temporary) || !fs.statSync(temporary).isDirectory())
18
+ throw new Error('DSH_SHARED_TEMP_INVALID');
19
+ const { installation, resource } = registration;
20
+ const env = {};
21
+ for (const [key, value] of Object.entries(process.env)) {
22
+ if (/^(PATH|PATHEXT|SYSTEMROOT|WINDIR|COMSPEC|USERPROFILE|HOME|HOMEDRIVE|HOMEPATH|APPDATA|LOCALAPPDATA)$/i.test(key))
23
+ env[key] = value;
24
+ }
25
+ Object.assign(env, { DSH_PACKAGE_PATH: installation.packagePath, DSH_HOME: resource.homePath,
26
+ TMPDIR: temporary, TEMP: temporary, TMP: temporary, DSH_TELEMETRY_DISABLED: '1' });
27
+ if (installation.kind === 'desktop')
28
+ env.ELECTRON_RUN_AS_NODE = '1';
29
+ const payload = JSON.stringify({ packagePath: installation.packagePath, homePath: resource.homePath,
30
+ profilePath: resource.profilePath, projectPath, ...selection });
31
+ const outcome = await new Promise((resolve, reject) => {
32
+ const child = spawn(installation.executablePath, ['--expose-internals',
33
+ path.join(getPackageRoot(), 'dist', 'agents', 'dsh', 'runtime', 'session-inspector.js')], { cwd: projectPath, env, windowsHide: true, stdio: ['ignore', 'pipe', 'pipe', 'pipe'] });
34
+ let stdout = '';
35
+ let stdoutBytes = 0;
36
+ let failure;
37
+ const stop = (code) => { failure = code; child.kill(); };
38
+ const timer = setTimeout(() => stop('DSH_SESSION_INSPECTION_TIMEOUT'), 20000);
39
+ const onAbort = () => stop('DSH_SESSION_INSPECTION_CANCELLED');
40
+ signal?.addEventListener('abort', onAbort, { once: true });
41
+ if (signal?.aborted)
42
+ onAbort();
43
+ const cleanup = () => { clearTimeout(timer); signal?.removeEventListener('abort', onAbort); };
44
+ child.stdout.setEncoding('utf8');
45
+ child.stdout.on('data', chunk => {
46
+ const part = chunk.toString();
47
+ stdoutBytes += Buffer.byteLength(part);
48
+ stdout += part;
49
+ const maxBytes = selection.action === 'history-all' ? 128 * 1024 * 1024 : selection.action === 'history' ? 8 * 1024 * 1024
50
+ : ['list', 'profile', 'catalog'].includes(selection.action ?? '') ? 128 * 1024 : 16 * 1024;
51
+ if (stdoutBytes > maxBytes)
52
+ stop('DSH_SESSION_INSPECTION_INVALID');
53
+ });
54
+ child.stderr.resume();
55
+ child.once('error', () => { cleanup(); reject(new Error('DSH_SESSION_INSPECTION_FAILED')); });
56
+ child.once('close', code => { cleanup(); failure ? reject(new Error(failure)) : resolve({ output: stdout, code }); });
57
+ const pipe = child.stdio[3];
58
+ pipe.on('error', () => stop('DSH_SESSION_INSPECTION_FAILED'));
59
+ pipe.end(payload);
60
+ });
61
+ let result;
62
+ try {
63
+ result = JSON.parse(outcome.output);
64
+ }
65
+ catch {
66
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
67
+ }
68
+ if (result?.protocol !== 'evolcore-dsh-session-inspect/1')
69
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
70
+ if (typeof result.error === 'string' && /^DSH_[A-Z_]+$/.test(result.error))
71
+ throw new Error(result.error);
72
+ if (outcome.code !== 0)
73
+ throw new Error('DSH_SESSION_INSPECTION_FAILED');
74
+ return result;
75
+ }
76
+ export const dshNativeSessionInspector = {
77
+ async version(registration, nativeSessionId, projectPath, signal) {
78
+ const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'version' }, signal);
79
+ if (result.action !== 'version' || result.nativeSessionId !== nativeSessionId || result.projectPath !== projectPath
80
+ || !/^[a-f0-9]{64}$/.test(result.version))
81
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
82
+ return result.version;
83
+ },
84
+ async historyAll(registration, nativeSessionId, projectPath, signal) {
85
+ const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'history-all', allowActive: true }, signal);
86
+ validateObservation(result, nativeSessionId, projectPath, true);
87
+ if (result.action !== 'history-all' || !/^[a-f0-9]{64}$/.test(result.version)
88
+ || !Array.isArray(result.events) || result.events.length !== result.eventCount || result.events.length > 1000000
89
+ || result.events.some((event, index) => !event || event.seq !== index || typeof event.type !== 'string'
90
+ || !event.data || typeof event.data !== 'object' || Array.isArray(event.data)))
91
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
92
+ return { version: result.version, events: result.events };
93
+ },
94
+ async fork(registration, nativeSessionId, projectPath, childId, expectedFingerprint, anchor, signal) {
95
+ const result = await inspectNativeSession(registration, projectPath, { action: 'fork', nativeSessionId, childId, expectedFingerprint, anchor }, signal);
96
+ if (result.nativeSessionId !== childId || !/^[a-f0-9]{64}$/.test(result.fingerprint))
97
+ throw new Error('DSH_FORK_RESULT_INVALID');
98
+ return result;
99
+ },
100
+ async discardFork(registration, nativeSessionId, projectPath, expectedFingerprint) {
101
+ await inspectNativeSession(registration, projectPath, { action: 'discard-fork', nativeSessionId, expectedFingerprint });
102
+ },
103
+ async catalog(registration) {
104
+ const result = await inspectNativeSession(registration, registration.resource.homePath, { action: 'catalog' });
105
+ if (result.action !== 'catalog' || typeof result.defaultModel !== 'string'
106
+ || !Array.isArray(result.models) || result.models.length > 1024
107
+ || result.models.some((model) => typeof model?.id !== 'string' || !model.id
108
+ || !Array.isArray(model.reasoningLevels) || model.reasoningLevels.some((level) => typeof level !== 'string'))) {
109
+ throw new Error('DSH_NATIVE_CATALOG_INVALID');
110
+ }
111
+ return { models: result.models, defaultModel: result.defaultModel,
112
+ revision: result.configurationRevision, source: 'native', freshness: 'fallback',
113
+ fetchedAt: new Date().toISOString(), diagnostics: [{ code: 'BUILTIN',
114
+ message: 'DSH installed adapter capabilities; account availability is checked when the task runs.' }] };
115
+ },
116
+ async profile(registration, projectPath = registration.resource.homePath) {
117
+ const result = await inspectNativeSession(registration, projectPath, { action: 'profile' });
118
+ if (result.action !== 'profile' || result.projectPath !== (process.platform === 'win32' ? projectPath.toLowerCase() : projectPath)
119
+ || !/^[a-f0-9]{64}$/.test(result.configurationRevision)
120
+ || !Array.isArray(result.plugins) || result.plugins.length > 512
121
+ || result.plugins.some((item) => !item || typeof item.id !== 'string' || typeof item.name !== 'string' || typeof item.enabled !== 'boolean')
122
+ || !Array.isArray(result.excluded) || result.excluded.length > 512 || result.excluded.some((item) => typeof item !== 'string')
123
+ || !Array.isArray(result.mcpServers) || result.mcpServers.length > 64
124
+ || result.mcpServers.some((item) => !item || typeof item.name !== 'string' || !/^[a-f0-9]{64}$/.test(item.fingerprint)
125
+ || typeof item.configuredEnabled !== 'boolean' || typeof item.transport !== 'string'
126
+ || !Number.isSafeInteger(item.argumentCount) || item.argumentCount < 0))
127
+ throw new Error('DSH_PROFILE_INSPECTION_INVALID');
128
+ return result;
129
+ },
130
+ async history(registration, nativeSessionId, projectPath, offset, signal, allowActive = false) {
131
+ if (!Number.isSafeInteger(offset) || offset < 0 || offset > 1000000)
132
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
133
+ const result = await inspectNativeSession(registration, projectPath, { nativeSessionId, action: 'history', offset,
134
+ ...(allowActive ? { allowActive: true } : {}) }, signal);
135
+ validateObservation(result, nativeSessionId, projectPath, allowActive);
136
+ if (result.action !== 'history' || result.offset !== offset || !Array.isArray(result.events)
137
+ || result.events.length > Math.min(256, result.eventCount - offset)
138
+ || (offset < result.eventCount && result.events.length === 0)
139
+ || result.events.some((event, index) => !event || event.seq !== offset + index
140
+ || typeof event.type !== 'string' || !event.data || typeof event.data !== 'object' || Array.isArray(event.data))) {
141
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
142
+ }
143
+ return result;
144
+ },
145
+ async list(registration, projectPath, offset = 0) {
146
+ if (!Number.isSafeInteger(offset) || offset < 0 || offset > 16384)
147
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
148
+ const result = await inspectNativeSession(registration, projectPath, { action: 'list', offset });
149
+ if (result.action !== 'list' || result.projectPath !== projectPath || !Array.isArray(result.sessions)
150
+ || result.sessions.length > 20 || !(result.nextOffset === null || result.nextOffset === offset + 20)
151
+ || result.sessions.some((item) => !item || item.projectPath !== projectPath
152
+ || typeof item.nativeSessionId !== 'string' || !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(item.nativeSessionId)
153
+ || typeof item.preset !== 'string' || !item.preset || item.preset.length > 256)
154
+ || new Set(result.sessions.map((item) => item.nativeSessionId)).size !== result.sessions.length) {
155
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
156
+ }
157
+ return result;
158
+ },
159
+ async inspect(registration, nativeSessionId, projectPath, allowActive = false, signal) {
160
+ const result = await inspectNativeSession(registration, projectPath, { nativeSessionId,
161
+ ...(allowActive ? { allowActive: true } : {}) }, signal);
162
+ validateObservation(result, nativeSessionId, projectPath, allowActive);
163
+ return result;
164
+ },
165
+ };
166
+ function validateObservation(result, nativeSessionId, projectPath, allowActive = false) {
167
+ if (result.nativeSessionId !== nativeSessionId || result.projectPath !== projectPath
168
+ || typeof result.preset !== 'string' || !result.preset || result.preset.length > 256
169
+ || !Number.isSafeInteger(result.eventCount) || result.eventCount < 0
170
+ || typeof result.storageRevision !== 'string' || result.storageRevision.length > 1024
171
+ || !/^[a-f0-9]{64}$/.test(result.configurationRevision) || !/^[a-f0-9]{64}$/.test(result.fingerprint)
172
+ || !(allowActive ? ['idle', 'empty', 'active'] : ['idle', 'empty']).includes(result.state))
173
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
174
+ }
175
+ function identityPath(file) {
176
+ return process.platform === 'win32' ? file.toLowerCase() : file;
177
+ }
178
+ function inspectPath(input, kind) {
179
+ if (process.platform === 'win32' && !/^[a-z]:[\\/]$/i.test(path.parse(input).root))
180
+ throw new Error('DSH_RESOURCE_PATH_INVALID: local drive paths are required');
181
+ if (!path.isAbsolute(input))
182
+ throw new Error('DSH_RESOURCE_PATH_INVALID: absolute paths are required');
183
+ const normalized = path.resolve(input);
184
+ let current = normalized;
185
+ while (true) {
186
+ const stat = fs.lstatSync(current);
187
+ if (stat.isSymbolicLink())
188
+ throw new Error('DSH_RESOURCE_PATH_INVALID: linked paths are not admitted');
189
+ const parent = path.dirname(current);
190
+ if (parent === current)
191
+ break;
192
+ current = parent;
193
+ }
194
+ const canonical = fs.realpathSync(normalized);
195
+ const stat = fs.statSync(canonical, { bigint: true });
196
+ if (kind === 'directory' ? !stat.isDirectory() : !stat.isFile())
197
+ throw new Error('DSH_RESOURCE_PATH_INVALID: incorrect path type');
198
+ return { path: canonical, identity: [stat.dev, stat.ino, stat.birthtimeNs].join(':') };
199
+ }
200
+ export function inspectDshNativeResource(installation, homePath, profilePath) {
201
+ if (!/^dsh-install-[a-f0-9]{64}$/.test(installation.installationId) || !/^[a-f0-9]{64}$/.test(installation.revision)) {
202
+ throw new Error('DSH_RESOURCE_PATH_INVALID: installation identity is invalid');
203
+ }
204
+ const home = inspectPath(homePath, 'directory');
205
+ const profile = inspectPath(profilePath, 'directory');
206
+ const profiles = path.join(home.path, 'profiles');
207
+ const relative = path.relative(profiles, profile.path);
208
+ if (!relative || relative === '..' || relative.startsWith(`..${path.sep}`) || path.isAbsolute(relative)) {
209
+ throw new Error('DSH_RESOURCE_PATH_INVALID: profile must be inside native Home/profiles');
210
+ }
211
+ const manifest = inspectPath(path.join(profile.path, 'package.json'), 'file');
212
+ if (fs.statSync(manifest.path).size > 256 * 1024)
213
+ throw new Error('DSH_RESOURCE_PROFILE_INVALID');
214
+ const bytes = fs.readFileSync(manifest.path);
215
+ let data;
216
+ try {
217
+ data = JSON.parse(bytes.toString('utf8'));
218
+ }
219
+ catch {
220
+ throw new Error('DSH_RESOURCE_PROFILE_INVALID: malformed profile manifest');
221
+ }
222
+ if (!data || !Array.isArray(data.dsh?.profile?.bundles)
223
+ || !data.dsh.profile.bundles.includes('@deepseek-ai/dsh-base')
224
+ || data.dsh.profile.bundles.some((bundle) => typeof bundle !== 'string')) {
225
+ throw new Error('DSH_RESOURCE_PROFILE_INVALID: expected a native base-backed profile');
226
+ }
227
+ const nativeResourceId = 'dsh-resource-' + dshIdentity([installation.installationId,
228
+ identityPath(home.path), identityPath(profile.path)]);
229
+ return Object.freeze({ nativeResourceId, installationId: installation.installationId,
230
+ installationRevision: installation.revision, homePath: home.path, profilePath: profile.path,
231
+ revision: dshIdentity([home.identity, profile.identity, manifest.identity, bytes.toString('base64')]) });
232
+ }
233
+ export function revalidateDshNativeResource(snapshot, installation) {
234
+ if (snapshot.installationId !== installation.installationId || snapshot.installationRevision !== installation.revision) {
235
+ throw new Error('DSH_RESOURCE_CHANGED: installation binding does not match');
236
+ }
237
+ const current = inspectDshNativeResource(installation, snapshot.homePath, snapshot.profilePath);
238
+ if (current.nativeResourceId !== snapshot.nativeResourceId || current.revision !== snapshot.revision) {
239
+ throw new Error('DSH_RESOURCE_CHANGED: resource paths or profile manifest changed');
240
+ }
241
+ return current;
242
+ }
243
+ // Daemon-local, never persisted. Restart invalidates every outstanding preview.
244
+ const sessionReceipts = new Map();
245
+ const SESSION_RECEIPT_TTL = 2 * 60 * 1000;
246
+ function fail(code) { throw new Error(code); }
247
+ function validSession(value) {
248
+ return typeof value === 'string' && /^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(value);
249
+ }
250
+ function validRevision(value) {
251
+ return typeof value === 'string' && /^[a-f0-9]{8}-[a-f0-9]{4}-4[a-f0-9]{3}-[89ab][a-f0-9]{3}-[a-f0-9]{12}$/.test(value);
252
+ }
253
+ function canonicalProject(value) {
254
+ if (typeof value !== 'string' || !path.isAbsolute(value))
255
+ fail('DSH_SHARED_PROJECT_INVALID');
256
+ noLinks(value);
257
+ const resolved = fs.realpathSync(value);
258
+ if (!fs.statSync(resolved).isDirectory())
259
+ fail('DSH_SHARED_PROJECT_INVALID');
260
+ return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
261
+ }
262
+ function object(value) {
263
+ return value !== null && typeof value === 'object' && !Array.isArray(value);
264
+ }
265
+ function noLinks(file) {
266
+ let current = path.resolve(file);
267
+ while (true) {
268
+ try {
269
+ if (fs.lstatSync(current).isSymbolicLink())
270
+ fail('DSH_REGISTRY_LINK_INVALID');
271
+ }
272
+ catch (error) {
273
+ if (error.code !== 'ENOENT')
274
+ throw error;
275
+ }
276
+ const parent = path.dirname(current);
277
+ if (parent === current)
278
+ return;
279
+ current = parent;
280
+ }
281
+ }
282
+ function ownership(agentAid, principalId) {
283
+ const daemonAid = ownerResolver.getDaemonAid();
284
+ if (!daemonAid || !ownerResolver.isOwner(agentAid, principalId) || !ownerResolver.isOwner(daemonAid, principalId)) {
285
+ fail('DSH_RESOURCE_OWNER_REQUIRED');
286
+ }
287
+ const agent = ownerResolver.snapshot(agentAid).consensus;
288
+ const daemon = ownerResolver.snapshot(daemonAid).consensus;
289
+ if (!agent || !daemon || !Number.isSafeInteger(agent.relation_version) || agent.relation_version < 1
290
+ || !Number.isSafeInteger(daemon.relation_version) || daemon.relation_version < 1)
291
+ fail('DSH_RESOURCE_OWNER_REQUIRED');
292
+ return { agentOwnershipVersion: agent.relation_version, daemonOwnershipVersion: daemon.relation_version };
293
+ }
294
+ async function authorize(subject, agentAid) {
295
+ if (!isValidAid(agentAid) || !subject.allowAccess || subject.chatType !== 'private' || subject.channelType !== 'aun'
296
+ || subject.actorId !== subject.principalId || !subject.principalId || !isValidAid(subject.principalId)
297
+ || subject.processRole !== 'daemon-owner' || !subject.isDaemonOwner
298
+ || (!subject.ecwebManagement && subject.menuEncrypted !== true))
299
+ fail('DSH_RESOURCE_OWNER_REQUIRED');
300
+ await refreshOwnershipForAuthorization(agentAid, { includeDaemon: true, allowTransient: false });
301
+ return { ownerAid: subject.principalId, ...ownership(agentAid, subject.principalId) };
302
+ }
303
+ function validateRecord(value) {
304
+ if (!object(value) || !isValidAid(value.agentAid) || !isValidAid(value.ownerAid)
305
+ || (value.scope !== undefined && value.scope !== 'host')
306
+ || !Number.isSafeInteger(value.agentOwnershipVersion) || value.agentOwnershipVersion < 1
307
+ || !Number.isSafeInteger(value.daemonOwnershipVersion) || value.daemonOwnershipVersion < 1
308
+ || !validRevision(value.revision)
309
+ || !object(value.resource) || !object(value.installation)
310
+ || value.mcpApprovals !== undefined && !validMcpApprovals(value.mcpApprovals))
311
+ return false;
312
+ const resource = value.resource;
313
+ const installation = value.installation;
314
+ return /^dsh-resource-[a-f0-9]{64}$/.test(resource.nativeResourceId)
315
+ && /^dsh-install-[a-f0-9]{64}$/.test(resource.installationId)
316
+ && /^[a-f0-9]{64}$/.test(resource.installationRevision) && /^[a-f0-9]{64}$/.test(resource.revision)
317
+ && typeof resource.homePath === 'string' && path.isAbsolute(resource.homePath)
318
+ && typeof resource.profilePath === 'string' && path.isAbsolute(resource.profilePath)
319
+ && resource.installationId === installation.installationId && resource.installationRevision === installation.revision
320
+ && ['desktop', 'cli'].includes(installation.kind) && typeof installation.packagePath === 'string'
321
+ && path.isAbsolute(installation.packagePath) && typeof installation.executablePath === 'string'
322
+ && path.isAbsolute(installation.executablePath);
323
+ }
324
+ function validMcpApprovals(value) {
325
+ return object(value) && Object.keys(value).length <= 64
326
+ && Object.entries(value).every(([name, fingerprint]) => name.length > 0 && name.length <= 256
327
+ && !['__proto__', 'prototype', 'constructor'].includes(name) && !/[\x00-\x1f]/.test(name)
328
+ && typeof fingerprint === 'string' && /^[a-f0-9]{64}$/.test(fingerprint));
329
+ }
330
+ function validateSession(value) {
331
+ return object(value) && isValidAid(value.agentAid) && validSession(value.ecSessionId)
332
+ && validSession(value.nativeSessionId) && typeof value.nativeResourceId === 'string'
333
+ && /^dsh-resource-[a-f0-9]{64}$/.test(value.nativeResourceId)
334
+ && validRevision(value.registrationRevision) && validRevision(value.revision)
335
+ && typeof value.projectPath === 'string' && path.isAbsolute(value.projectPath);
336
+ }
337
+ export class DshNativeResourceRegistry {
338
+ validateEcSession;
339
+ constructor(validateEcSession) {
340
+ this.validateEcSession = validateEcSession;
341
+ }
342
+ async assertForkSource(agentAid, nativeId, projectPath, ecSessionId, subject) {
343
+ if (!subject.allowAccess || subject.selfAid !== agentAid || subject.role !== 'owner'
344
+ || !subject.principalId || subject.actorId !== subject.principalId)
345
+ fail('DSH_FORK_AUTHORITY_REQUIRED');
346
+ await refreshOwnershipForAuthorization(agentAid, { allowTransient: false });
347
+ if (!ownerResolver.owners(agentAid).includes(subject.principalId))
348
+ fail('DSH_FORK_AUTHORITY_REQUIRED');
349
+ const binding = await this.findNativeSession(agentAid, nativeId, projectPath);
350
+ if (!binding || binding.ecSessionId !== ecSessionId)
351
+ fail('DSH_SESSION_BINDING_MISMATCH');
352
+ return binding;
353
+ }
354
+ /** Bind a fork only to the destination returned by the Host session manager, without a synthetic task lease. */
355
+ async commitFork(agentAid, source, projectPath, sourceEcId, subject, target, childId, anchor, signal) {
356
+ const parent = await this.assertForkSource(agentAid, source, projectPath, sourceEcId, subject);
357
+ if (!validSession(childId) || !validSession(target.id) || target.id === sourceEcId
358
+ || target.sourceSessionId !== sourceEcId
359
+ || target.selfAID !== agentAid || target.baseagent !== 'dsh' || target.agentSessionId !== childId
360
+ || canonicalProject(target.projectPath) !== parent.projectPath || target.processingState)
361
+ fail('DSH_FORK_TARGET_INVALID');
362
+ const registration = await this.resolve(agentAid, parent.nativeResourceId, parent.registrationRevision);
363
+ const observation = await dshNativeSessionInspector.inspect(registration, source, parent.projectPath);
364
+ const verifySource = async () => {
365
+ const current = await this.assertForkSource(agentAid, source, projectPath, sourceEcId, subject);
366
+ if (current.revision !== parent.revision || current.nativeResourceId !== parent.nativeResourceId
367
+ || current.registrationRevision !== parent.registrationRevision)
368
+ fail('DSH_SESSION_CHANGED');
369
+ };
370
+ const file = this.file();
371
+ await withFileLock(file + '.lock', async () => {
372
+ await verifySource();
373
+ const state = this.read();
374
+ if (state.sessions.some(item => item.agentAid === agentAid && item.ecSessionId === target.id
375
+ || item.nativeResourceId === parent.nativeResourceId && item.nativeSessionId === childId))
376
+ fail('DSH_SESSION_ALREADY_BOUND');
377
+ if (state.sessions.length >= 4096)
378
+ fail('DSH_REGISTRY_LIMIT');
379
+ const previous = structuredClone(state);
380
+ const child = await dshNativeSessionInspector.fork(registration, source, parent.projectPath, childId, observation.fingerprint, anchor, signal);
381
+ let published = false;
382
+ try {
383
+ await verifySource();
384
+ await this.resolve(agentAid, parent.nativeResourceId, parent.registrationRevision);
385
+ state.sessions.push({ ...parent, ecSessionId: target.id, nativeSessionId: childId, revision: randomUUID() });
386
+ state.revision = randomUUID();
387
+ const content = JSON.stringify(state, null, 2) + '\n';
388
+ if (Buffer.byteLength(content) > 1024 * 1024)
389
+ fail('DSH_REGISTRY_LIMIT');
390
+ await atomicReplaceJson(file, state);
391
+ published = true;
392
+ registerContent(file, content, registration.ownerAid);
393
+ }
394
+ catch (error) {
395
+ if (published) {
396
+ try {
397
+ await atomicReplaceJson(file, previous);
398
+ registerContent(file, JSON.stringify(previous, null, 2) + '\n', registration.ownerAid);
399
+ }
400
+ catch (rollbackError) {
401
+ throw new AggregateError([error, rollbackError], 'DSH_FORK_ROLLBACK_FAILED');
402
+ }
403
+ }
404
+ // Only the newly created, unchanged child can be removed. Never remove an attached child.
405
+ if (!this.read().sessions.some(item => item.nativeResourceId === parent.nativeResourceId && item.nativeSessionId === childId)) {
406
+ await dshNativeSessionInspector.discardFork(registration, childId, parent.projectPath, child.fingerprint);
407
+ }
408
+ throw error;
409
+ }
410
+ });
411
+ }
412
+ async ecRevision(agentAid, ownerAid, sessionId, projectPath) {
413
+ if (!this.validateEcSession)
414
+ fail('DSH_EC_SESSION_UNAVAILABLE');
415
+ return this.validateEcSession(agentAid, ownerAid, sessionId, projectPath);
416
+ }
417
+ file() { return path.join(resolveRoot(), 'data', 'dsh', 'native-resources.json'); }
418
+ read() {
419
+ const file = this.file();
420
+ noLinks(file);
421
+ if (!fs.existsSync(file)) {
422
+ if (queryRecord(file))
423
+ fail('DSH_REGISTRY_INTEGRITY_INVALID');
424
+ return { version: 1, revision: 'uninitialized', resources: [], sessions: [] };
425
+ }
426
+ if (!fs.statSync(file).isFile() || fs.statSync(file).size > 1024 * 1024)
427
+ fail('DSH_REGISTRY_INVALID');
428
+ const verified = verifyFile(file, { requireRegistered: true, restoreOnFail: false });
429
+ if (verified.status !== 'verified' || !verified.bytes)
430
+ fail('DSH_REGISTRY_INTEGRITY_INVALID');
431
+ let state;
432
+ try {
433
+ state = JSON.parse(verified.bytes.toString('utf8'));
434
+ }
435
+ catch {
436
+ fail('DSH_REGISTRY_INVALID');
437
+ }
438
+ if (!object(state) || state.version !== 1 || typeof state.revision !== 'string'
439
+ || !validRevision(state.revision) || !Array.isArray(state.resources) || state.resources.length > 128
440
+ || !state.resources.every(validateRecord))
441
+ fail('DSH_REGISTRY_INVALID');
442
+ state.sessions ??= [];
443
+ if (!Array.isArray(state.sessions) || state.sessions.length > 4096 || !state.sessions.every(validateSession))
444
+ fail('DSH_REGISTRY_INVALID');
445
+ const keys = state.resources.map(record => `${record.agentAid}/${record.resource.nativeResourceId}${record.scope === 'host' ? '/' + record.revision : ''}`);
446
+ if (new Set(keys).size !== keys.length)
447
+ fail('DSH_REGISTRY_INVALID');
448
+ const sessionKeys = state.sessions.map(binding => `${binding.agentAid}/${binding.ecSessionId}`);
449
+ const nativeKeys = state.sessions.map(binding => `${binding.nativeResourceId}/${binding.nativeSessionId}`);
450
+ if (new Set(sessionKeys).size !== sessionKeys.length || new Set(nativeKeys).size !== nativeKeys.length)
451
+ fail('DSH_REGISTRY_INVALID');
452
+ return state;
453
+ }
454
+ async preview(subject, agentAid, input) {
455
+ await authorize(subject, agentAid);
456
+ const installation = await selectDshNativeInstallation(input.installationId);
457
+ const resource = inspectDshNativeResource(installation, input.homePath, input.profilePath);
458
+ await authorize(subject, agentAid);
459
+ return { installation, resource, registryRevision: this.read().revision };
460
+ }
461
+ async register(subject, agentAid, input) {
462
+ await authorize(subject, agentAid);
463
+ if (input.scope === 'host' && agentAid !== ownerResolver.getDaemonAid())
464
+ fail('DSH_RESOURCE_OWNER_REQUIRED');
465
+ if (input.sharingConsent !== 'native-resources')
466
+ fail('DSH_RESOURCE_CONSENT_REQUIRED');
467
+ const installation = await selectDshNativeInstallation(input.installation.installationId);
468
+ if (installation.revision !== input.installation.revision)
469
+ fail('DSH_INSTALLATION_CHANGED');
470
+ const resource = revalidateDshNativeResource(input.resource, installation);
471
+ return this.mutate(subject, agentAid, input.expectedRegistryRevision, (state, authority) => {
472
+ const next = { agentAid, ...authority, installation, resource, revision: randomUUID(),
473
+ ...(input.scope === 'host' ? { scope: 'host' } : {}) };
474
+ // Keep prior host grants pinned for existing bindings. Changing the host
475
+ // default must not silently rebind already-authorized conversations.
476
+ if (input.scope !== 'host')
477
+ state.resources = state.resources.filter(record => record.agentAid !== agentAid
478
+ || record.resource.nativeResourceId !== resource.nativeResourceId);
479
+ if (state.resources.length >= 128)
480
+ fail('DSH_REGISTRY_LIMIT');
481
+ state.resources.push(next);
482
+ return structuredClone(next);
483
+ });
484
+ }
485
+ async revoke(subject, agentAid, nativeResourceId, expectedRegistryRevision) {
486
+ await this.mutate(subject, agentAid, expectedRegistryRevision, state => {
487
+ state.resources = state.resources.filter(record => record.agentAid !== agentAid
488
+ || record.resource.nativeResourceId !== nativeResourceId);
489
+ });
490
+ }
491
+ async inspect(subject, agentAid) {
492
+ const authority = await authorize(subject, agentAid);
493
+ const state = this.read();
494
+ return { revision: state.revision, resources: structuredClone(state.resources.filter(record => record.agentAid === agentAid
495
+ || record.scope === 'host' && record.agentAid === ownerResolver.getDaemonAid() && record.ownerAid === authority.ownerAid)) };
496
+ }
497
+ async profile(subject, agentAid, nativeResourceId, registrationRevision) {
498
+ await authorize(subject, agentAid);
499
+ const registration = await this.resolve(agentAid, nativeResourceId, registrationRevision);
500
+ const profile = await dshNativeSessionInspector.profile(registration);
501
+ await authorize(subject, agentAid);
502
+ const current = await this.resolve(agentAid, nativeResourceId, registrationRevision);
503
+ return { ...profile, mcpServers: profile.mcpServers.map(server => ({ ...server,
504
+ enabled: server.configuredEnabled && current.mcpApprovals?.[server.name] === server.fingerprint })),
505
+ registryRevision: this.read().revision };
506
+ }
507
+ async setMcpApprovals(subject, agentAid, input) {
508
+ if (input.sharingConsent !== 'native-mcp-startup' || !validMcpApprovals(input.approvals))
509
+ fail('DSH_MCP_CONSENT_REQUIRED');
510
+ const observation = await this.profile(subject, agentAid, input.nativeResourceId, input.registrationRevision);
511
+ if (Object.entries(input.approvals).some(([name, fingerprint]) => !observation.mcpServers.some(server => server.name === name && server.fingerprint === fingerprint && server.configuredEnabled)))
512
+ fail('DSH_MCP_CONFIGURATION_CHANGED');
513
+ await this.mutate(subject, agentAid, input.expectedRegistryRevision, state => {
514
+ const registration = state.resources.find(entry => entry.agentAid === agentAid
515
+ && entry.resource.nativeResourceId === input.nativeResourceId && entry.revision === input.registrationRevision);
516
+ if (!registration)
517
+ fail('DSH_RESOURCE_OWNER_REQUIRED'); // Host grants are managed only from the host.
518
+ registration.mcpApprovals = { ...input.approvals };
519
+ });
520
+ }
521
+ async discoverSessions(subject, agentAid, input) {
522
+ await authorize(subject, agentAid);
523
+ const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
524
+ const result = await dshNativeSessionInspector.list(registration, canonicalProject(input.projectPath), input.offset ?? 0);
525
+ await authorize(subject, agentAid);
526
+ await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
527
+ return result;
528
+ }
529
+ async previewSession(subject, agentAid, input) {
530
+ const authority = await authorize(subject, agentAid);
531
+ if (!validSession(input.ecSessionId) || !validSession(input.nativeSessionId))
532
+ fail('DSH_SESSION_BINDING_INVALID');
533
+ const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
534
+ const projectPath = canonicalProject(input.projectPath);
535
+ const ecRevision = await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath);
536
+ const observation = await dshNativeSessionInspector.inspect(registration, input.nativeSessionId, projectPath);
537
+ await authorize(subject, agentAid);
538
+ await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
539
+ if (await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath) !== ecRevision)
540
+ fail('DSH_EC_SESSION_CHANGED');
541
+ const state = this.read();
542
+ if (state.sessions.some(binding => binding.agentAid === agentAid && binding.ecSessionId === input.ecSessionId
543
+ || binding.nativeResourceId === input.nativeResourceId && binding.nativeSessionId === input.nativeSessionId))
544
+ fail('DSH_SESSION_ALREADY_BOUND');
545
+ for (const [key, value] of sessionReceipts)
546
+ if (value.expiresAt <= Date.now())
547
+ sessionReceipts.delete(key);
548
+ if (sessionReceipts.size >= 256)
549
+ fail('DSH_SESSION_PREVIEW_LIMIT');
550
+ const receipt = randomBytes(32).toString('hex');
551
+ const expiresAt = Date.now() + SESSION_RECEIPT_TTL;
552
+ sessionReceipts.set(receipt, { ownerAid: authority.ownerAid, agentAid, ecSessionId: input.ecSessionId,
553
+ nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
554
+ registryRevision: state.revision, observation: structuredClone(observation), ecRevision, expiresAt });
555
+ return { receipt, expiresAt, registryRevision: state.revision, session: structuredClone(observation) };
556
+ }
557
+ async bindSession(subject, agentAid, input) {
558
+ const authority = await authorize(subject, agentAid);
559
+ if (input.sharingConsent !== 'native-session')
560
+ fail('DSH_SESSION_CONSENT_REQUIRED');
561
+ if (!validSession(input.ecSessionId) || !validSession(input.nativeSessionId))
562
+ fail('DSH_SESSION_BINDING_INVALID');
563
+ const projectPath = canonicalProject(input.projectPath);
564
+ const receipt = sessionReceipts.get(input.receipt);
565
+ if (!receipt || receipt.ownerAid !== authority.ownerAid || receipt.agentAid !== agentAid
566
+ || receipt.ecSessionId !== input.ecSessionId || receipt.nativeResourceId !== input.nativeResourceId
567
+ || receipt.registrationRevision !== input.registrationRevision || receipt.registryRevision !== input.expectedRegistryRevision
568
+ || receipt.observation.nativeSessionId !== input.nativeSessionId || receipt.observation.projectPath !== projectPath) {
569
+ fail('DSH_SESSION_RECEIPT_INVALID');
570
+ }
571
+ // Consume synchronously before awaiting: two concurrent submissions cannot reuse a receipt.
572
+ sessionReceipts.delete(input.receipt);
573
+ if (receipt.expiresAt <= Date.now())
574
+ fail('DSH_SESSION_RECEIPT_EXPIRED');
575
+ return this.mutate(subject, agentAid, input.expectedRegistryRevision, async (state) => {
576
+ const registration = await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
577
+ const observed = await dshNativeSessionInspector.inspect(registration, input.nativeSessionId, projectPath);
578
+ if (receipt.expiresAt <= Date.now())
579
+ fail('DSH_SESSION_RECEIPT_EXPIRED');
580
+ if (observed.fingerprint !== receipt.observation.fingerprint)
581
+ fail('DSH_SESSION_CHANGED');
582
+ await this.resolve(agentAid, input.nativeResourceId, input.registrationRevision);
583
+ if (await this.ecRevision(agentAid, authority.ownerAid, input.ecSessionId, projectPath) !== receipt.ecRevision)
584
+ fail('DSH_EC_SESSION_CHANGED');
585
+ if (!state.resources.some(record => (record.agentAid === agentAid || record.scope === 'host'
586
+ && record.agentAid === ownerResolver.getDaemonAid() && record.ownerAid === authority.ownerAid) && record.resource.nativeResourceId === input.nativeResourceId
587
+ && record.revision === input.registrationRevision))
588
+ fail('DSH_RESOURCE_NOT_REGISTERED');
589
+ const current = state.sessions.find(binding => binding.agentAid === agentAid && binding.ecSessionId === input.ecSessionId);
590
+ if (current)
591
+ fail('DSH_SESSION_ALREADY_BOUND');
592
+ if (state.sessions.some(binding => binding.nativeResourceId === input.nativeResourceId
593
+ && binding.nativeSessionId === input.nativeSessionId))
594
+ fail('DSH_SESSION_ALREADY_BOUND');
595
+ if (state.sessions.length >= 4096)
596
+ fail('DSH_REGISTRY_LIMIT');
597
+ const binding = { agentAid, ecSessionId: input.ecSessionId,
598
+ nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
599
+ nativeSessionId: input.nativeSessionId, projectPath, revision: randomUUID() };
600
+ state.sessions.push(binding);
601
+ return structuredClone(binding);
602
+ });
603
+ }
604
+ async revokeSession(subject, agentAid, ecSessionId, expectedRegistryRevision) {
605
+ await this.mutate(subject, agentAid, expectedRegistryRevision, state => {
606
+ state.sessions = state.sessions.filter(binding => binding.agentAid !== agentAid || binding.ecSessionId !== ecSessionId);
607
+ });
608
+ }
609
+ async inspectSessions(subject, agentAid) {
610
+ await authorize(subject, agentAid);
611
+ const state = this.read();
612
+ return { revision: state.revision, sessions: structuredClone(state.sessions.filter(binding => binding.agentAid === agentAid)) };
613
+ }
614
+ /** Enumerate candidates only; each Agent still requires inspectSessions authorization. */
615
+ async sessionAgentCandidates(subject) {
616
+ const daemonAid = ownerResolver.getDaemonAid();
617
+ if (!daemonAid)
618
+ fail('DSH_RESOURCE_OWNER_REQUIRED');
619
+ await authorize(subject, daemonAid);
620
+ return [...new Set(this.read().sessions.map(binding => binding.agentAid))];
621
+ }
622
+ async resolveSession(agentAid, ecSessionId, expectedRevision) {
623
+ const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
624
+ if (!binding || binding.revision !== expectedRevision)
625
+ fail('DSH_SESSION_NOT_BOUND');
626
+ await this.resolve(agentAid, binding.nativeResourceId, binding.registrationRevision);
627
+ if (canonicalProject(binding.projectPath) !== binding.projectPath)
628
+ fail('DSH_SHARED_PROJECT_INVALID');
629
+ const latest = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
630
+ if (!latest || latest.revision !== binding.revision)
631
+ fail('DSH_SESSION_NOT_BOUND');
632
+ return structuredClone(binding);
633
+ }
634
+ assertSessionUnbound(agentAid, ecSessionId) {
635
+ if (!isValidAid(agentAid) || !validSession(ecSessionId))
636
+ fail('DSH_SESSION_BINDING_INVALID');
637
+ if (this.read().sessions.some(binding => binding.agentAid === agentAid && binding.ecSessionId === ecSessionId)) {
638
+ fail('DSH_SESSION_ALREADY_BOUND');
639
+ }
640
+ }
641
+ async sessionForTask(agentAid, ecSessionId) {
642
+ const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.ecSessionId === ecSessionId);
643
+ if (!binding)
644
+ fail('DSH_SESSION_NOT_BOUND');
645
+ return this.resolveSession(agentAid, ecSessionId, binding.revision);
646
+ }
647
+ async findNativeSession(agentAid, nativeSessionId, projectPath) {
648
+ if (!isValidAid(agentAid) || !validSession(nativeSessionId))
649
+ fail('DSH_SESSION_BINDING_INVALID');
650
+ const binding = this.read().sessions.find(record => record.agentAid === agentAid && record.nativeSessionId === nativeSessionId);
651
+ if (!binding)
652
+ return undefined;
653
+ if (canonicalProject(projectPath) !== binding.projectPath)
654
+ fail('DSH_SESSION_PROJECT_MISMATCH');
655
+ return this.resolveSession(agentAid, binding.ecSessionId, binding.revision);
656
+ }
657
+ /** Internal creation receipt: callers must obtain the ID from this task's fixed owned child. */
658
+ async recordCreatedSession(input) {
659
+ const authorizeTask = async () => {
660
+ const { identity, permission } = input;
661
+ const check = () => {
662
+ if (permission.selfAid !== input.agentAid || !permission.turn || !permission.revalidateExecutionIdentity
663
+ || ['sessionId', 'taskId', 'turnId', 'generation'].some(key => identity[key]
664
+ !== permission.turn[key]))
665
+ fail('DSH_SHARED_TASK_AUTHORITY_REQUIRED');
666
+ };
667
+ check();
668
+ await assertOwnershipAuthorization(permission);
669
+ check();
670
+ };
671
+ if (!validSession(input.identity.sessionId) || !validSession(input.nativeSessionId))
672
+ fail('DSH_SESSION_BINDING_INVALID');
673
+ await authorizeTask();
674
+ await this.resolve(input.agentAid, input.nativeResourceId, input.registrationRevision);
675
+ const projectPath = canonicalProject(input.projectPath);
676
+ const file = this.file();
677
+ noLinks(file);
678
+ return withFileLock(file + '.lock', async () => {
679
+ await authorizeTask();
680
+ const registration = await this.resolve(input.agentAid, input.nativeResourceId, input.registrationRevision);
681
+ const state = this.read();
682
+ if (state.sessions.some(binding => binding.agentAid === input.agentAid && binding.ecSessionId === input.identity.sessionId
683
+ || binding.nativeResourceId === input.nativeResourceId && binding.nativeSessionId === input.nativeSessionId)) {
684
+ fail('DSH_SESSION_ALREADY_BOUND');
685
+ }
686
+ if (state.sessions.length >= 4096)
687
+ fail('DSH_REGISTRY_LIMIT');
688
+ const binding = { agentAid: input.agentAid, ecSessionId: input.identity.sessionId,
689
+ nativeResourceId: input.nativeResourceId, registrationRevision: input.registrationRevision,
690
+ nativeSessionId: input.nativeSessionId, projectPath, revision: randomUUID() };
691
+ state.sessions.push(binding);
692
+ state.revision = randomUUID();
693
+ if (Buffer.byteLength(JSON.stringify(state, null, 2) + '\n') > 1024 * 1024)
694
+ fail('DSH_REGISTRY_LIMIT');
695
+ await atomicReplaceJson(file, state);
696
+ registerContent(file, JSON.stringify(state, null, 2) + '\n', registration.ownerAid);
697
+ return structuredClone(binding);
698
+ });
699
+ }
700
+ async resolve(agentAid, nativeResourceId, expectedRevision) {
701
+ if (!isValidAid(agentAid) || !/^dsh-resource-[a-f0-9]{64}$/.test(nativeResourceId))
702
+ fail('DSH_RESOURCE_NOT_REGISTERED');
703
+ const eligible = (record) => record.resource.nativeResourceId === nativeResourceId
704
+ && record.revision === expectedRevision && (record.agentAid === agentAid
705
+ || record.scope === 'host' && record.agentAid === ownerResolver.getDaemonAid());
706
+ const current = this.read().resources.find(eligible);
707
+ if (!current || current.revision !== expectedRevision)
708
+ fail('DSH_RESOURCE_NOT_REGISTERED');
709
+ await refreshOwnershipForAuthorization(agentAid, { includeDaemon: true, allowTransient: false });
710
+ const authority = ownership(agentAid, current.ownerAid);
711
+ if (current.scope !== 'host' && authority.agentOwnershipVersion !== current.agentOwnershipVersion
712
+ || authority.daemonOwnershipVersion !== current.daemonOwnershipVersion)
713
+ fail('DSH_RESOURCE_CONSENT_EXPIRED');
714
+ const installation = revalidateDshNativeInstallation(current.installation);
715
+ const resource = revalidateDshNativeResource(current.resource, installation);
716
+ const latest = this.read().resources.find(eligible);
717
+ if (!latest || latest.revision !== current.revision)
718
+ fail('DSH_RESOURCE_NOT_REGISTERED');
719
+ ownership(agentAid, current.ownerAid);
720
+ return structuredClone({ ...latest, agentAid, agentOwnershipVersion: authority.agentOwnershipVersion, installation, resource });
721
+ }
722
+ async mutate(subject, agentAid, expectedRevision, change) {
723
+ await authorize(subject, agentAid);
724
+ const file = this.file();
725
+ noLinks(file);
726
+ return withFileLock(file + '.lock', async () => {
727
+ noLinks(file);
728
+ const authority = await authorize(subject, agentAid);
729
+ const state = this.read();
730
+ if (state.revision !== expectedRevision)
731
+ fail('DSH_REGISTRY_REVISION_CONFLICT');
732
+ const result = await change(state, authority);
733
+ const latestAuthority = await authorize(subject, agentAid);
734
+ if (JSON.stringify(latestAuthority) !== JSON.stringify(authority))
735
+ fail('DSH_RESOURCE_CONSENT_EXPIRED');
736
+ if (this.read().revision !== expectedRevision)
737
+ fail('DSH_REGISTRY_REVISION_CONFLICT');
738
+ state.revision = randomUUID();
739
+ if (Buffer.byteLength(JSON.stringify(state, null, 2) + '\n') > 1024 * 1024)
740
+ fail('DSH_REGISTRY_LIMIT');
741
+ await atomicReplaceJson(file, state);
742
+ registerContent(file, JSON.stringify(state, null, 2) + '\n', authority.ownerAid);
743
+ return result;
744
+ });
745
+ }
746
+ }
747
+ /** Catalog reads use the same resource and ownership checks as execution. */
748
+ export async function getDshNativeCatalog(config, aid) {
749
+ const principal = aid ?? ownerResolver.getDaemonAid();
750
+ if (!principal || typeof config.nativeResourceId !== 'string' || typeof config.nativeRegistrationRevision !== 'string') {
751
+ throw new Error('DSH_RESOURCE_NOT_REGISTERED');
752
+ }
753
+ const registration = await new DshNativeResourceRegistry().resolve(principal, config.nativeResourceId, config.nativeRegistrationRevision);
754
+ return dshNativeSessionInspector.catalog(registration);
755
+ }