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,340 @@
1
+ import fs from 'node:fs';
2
+ import path from 'node:path';
3
+ import { createHash } from 'node:crypto';
4
+ import { createRequire } from 'node:module';
5
+ import { pathToFileURL } from 'node:url';
6
+ import { createNativeSharedComposition, NATIVE_SHARED_VERSION, validateNativeStorage, assertNativeStoragePath } from './config.js';
7
+ const protocol = 'evolcore-dsh-session-inspect/1';
8
+ const canonical = (value) => process.platform === 'win32' ? value.toLowerCase() : value;
9
+ const digest = (value) => createHash('sha256').update(value).digest('hex');
10
+ /** Keep the response below the IPC limit while avoiding a process per 32 events. */
11
+ export function historyPage(events, offset) {
12
+ const page = [];
13
+ let bytes = 0;
14
+ for (const event of events.slice(offset, offset + 256)) {
15
+ const size = Buffer.byteLength(JSON.stringify(event)) + 1;
16
+ if (page.length && bytes + size > 6 * 1024 * 1024)
17
+ break;
18
+ page.push(event);
19
+ bytes += size;
20
+ }
21
+ return page;
22
+ }
23
+ export function sessionState(events, allowActive = false) {
24
+ let lastTurn;
25
+ for (let index = events.length - 1; index >= 0; index--) {
26
+ if (events[index].type === 'turn/end' || events[index].type === 'turn/start') {
27
+ lastTurn = events[index];
28
+ break;
29
+ }
30
+ }
31
+ if (lastTurn?.type === 'turn/start') {
32
+ if (!allowActive)
33
+ throw new Error('DSH_SESSION_ACTIVE');
34
+ return 'active';
35
+ }
36
+ return lastTurn?.type === 'turn/end' ? 'idle' : 'empty';
37
+ }
38
+ // Native listing must not traverse links before the selected artifact is checked.
39
+ function checkTree(root) {
40
+ let count = 0;
41
+ function visit(directory, depth) {
42
+ for (const item of fs.readdirSync(directory, { withFileTypes: true })) {
43
+ if (++count > 16384)
44
+ throw new Error('DSH_SESSION_STORE_LIMIT');
45
+ const file = path.join(directory, item.name);
46
+ assertNativeStoragePath(file, root);
47
+ if (item.isDirectory() && depth < 2)
48
+ visit(file, depth + 1);
49
+ }
50
+ }
51
+ visit(root, 0);
52
+ }
53
+ /** Load only the pinned persistence plugin; no Agent, Provider, MCP or profile plugin runs. */
54
+ export async function inspectNativeSession(input) {
55
+ if (!input || Object.keys(input).some(key => !['packagePath', 'homePath', 'profilePath', 'projectPath', 'nativeSessionId', 'action', 'offset', 'allowActive', 'childId', 'anchor', 'expectedFingerprint'].includes(key))
56
+ || ![undefined, 'inspect', 'list', 'history', 'history-all', 'version', 'profile', 'catalog', 'fork', 'discard-fork'].includes(input.action)
57
+ || (input.allowActive !== undefined && (input.allowActive !== true || ![undefined, 'inspect', 'history', 'history-all'].includes(input.action)))
58
+ || (!['list', 'profile', 'catalog'].includes(input.action ?? '') && !/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(input.nativeSessionId ?? ''))
59
+ || (['profile', 'catalog'].includes(input.action ?? '') && (input.nativeSessionId !== undefined || input.offset !== undefined))
60
+ || (input.action === 'list' && (input.nativeSessionId !== undefined || !Number.isSafeInteger(input.offset) || input.offset < 0 || input.offset > 16384))
61
+ || (input.action === 'history' && (!Number.isSafeInteger(input.offset) || input.offset < 0 || input.offset > 1000000))
62
+ || (['fork', 'discard-fork'].includes(input.action ?? '') && !/^[a-f0-9]{64}$/.test(input.expectedFingerprint ?? ''))
63
+ || (input.action === 'fork' && (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(input.childId ?? '')
64
+ || input.childId === input.nativeSessionId || input.anchor !== undefined && !/^dsh-\d+$/.test(input.anchor)))
65
+ || (input.action !== 'fork' && (input.childId !== undefined || input.anchor !== undefined))
66
+ || (!['fork', 'discard-fork'].includes(input.action ?? '') && input.expectedFingerprint !== undefined)
67
+ || ['packagePath', 'homePath', 'profilePath', 'projectPath'].some(key => typeof input[key] !== 'string' || !path.isAbsolute(input[key]))) {
68
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
69
+ }
70
+ if (input.packagePath !== process.env.DSH_PACKAGE_PATH || input.homePath !== process.env.DSH_HOME) {
71
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
72
+ }
73
+ const manifest = JSON.parse(fs.readFileSync(input.packagePath, 'utf8'));
74
+ if (manifest.name !== '@deepseek-ai/dsh' || manifest.version !== NATIVE_SHARED_VERSION)
75
+ throw new Error('DSH_VERSION_UNSUPPORTED');
76
+ const requireNative = createRequire(input.packagePath);
77
+ const load = (name) => import(pathToFileURL(requireNative.resolve(name)).href);
78
+ const { loadProfileDirectory, readProfilePatches, composeEntries } = await load('@deepseek-ai/dsh-app-boot');
79
+ const home = fs.realpathSync(input.homePath);
80
+ const profile = fs.realpathSync(input.profilePath);
81
+ const project = canonical(fs.realpathSync(input.projectPath));
82
+ assertNativeStoragePath(profile, home);
83
+ const loaded = loadProfileDirectory('evolcore-dsh', profile, input.packagePath);
84
+ if (loaded.skippedBundles.length)
85
+ throw new Error('DSH_SHARED_COMPOSITION_INVALID');
86
+ const profileContext = { name: loaded.name, dir: profile, patchPath: loaded.patchPath, installAnchor: input.packagePath,
87
+ cwd: project, home, overlays: [], startedBundles: loaded.layers.map((layer) => layer.packageName) };
88
+ const entries = composeEntries([readProfilePatches('evolcore-dsh', profileContext, loaded)]);
89
+ const trustedEntries = composeEntries([loaded.layers.filter((layer) => ['@deepseek-ai/dsh-base', '@deepseek-ai/dsh-web-app'].includes(layer.packageName)).flatMap((layer) => layer.patches)]);
90
+ const composition = createNativeSharedComposition(entries, { projectPath: project, trustedEntries });
91
+ if (input.action === 'catalog') {
92
+ const selection = composition.entries.find(entry => entry.id === 'agent-default-model')?.config;
93
+ if (typeof selection?.provider !== 'string' || typeof selection.model !== 'string')
94
+ throw new Error('DSH_NATIVE_MODEL_UNAVAILABLE');
95
+ const providerEntry = composition.entries.find(entry => entry.id === (selection.provider === 'deepseek-account' ? 'llm-deepseek-account' : 'llm-deepseek'));
96
+ if (!['deepseek-official', 'deepseek-account'].includes(selection.provider) || providerEntry?.disabled === true) {
97
+ throw new Error('DSH_NATIVE_CATALOG_UNAVAILABLE');
98
+ }
99
+ // Read the installed adapter's local capabilities, without activating
100
+ // credentials, MCP, Agents, account refreshes or remote model listings.
101
+ const { resolveAdapterOptions, resolveListedCatalog, DeepSeekAdapter } = await load('@deepseek-ai/dsh-llm-deepseek');
102
+ const { APP_IDENTITY } = await load('@deepseek-ai/dsh-llm');
103
+ const { loadLayeredEnv } = await load('@deepseek-ai/dsh-app-boot');
104
+ let options;
105
+ if (selection.provider === 'deepseek-account') {
106
+ const { resolveAccountOptions } = await load('@deepseek-ai/dsh-llm-deepseek-account');
107
+ const account = resolveAccountOptions(providerEntry?.config ?? {}, loadLayeredEnv('dsh'));
108
+ const catalog = resolveListedCatalog({ supported: account.protocol.models, overrides: account.modelOverrides,
109
+ routeMaxTokens: account.protocol.maxTokens, clientVersion: APP_IDENTITY.version });
110
+ options = { ...account.protocol, models: catalog.resolution };
111
+ }
112
+ else
113
+ options = resolveAdapterOptions(providerEntry?.config ?? {}, loadLayeredEnv('dsh'));
114
+ const adapter = new DeepSeekAdapter({ options: () => options,
115
+ resolveAuth: async () => { throw new Error('DSH_NATIVE_CATALOG_READ_ONLY'); } });
116
+ const ids = [...new Set([...options.models.map((model) => model.id), selection.model])];
117
+ const models = await Promise.all(ids.map(async (id) => {
118
+ const info = await adapter.resolveModel(selection.provider, id);
119
+ const contextWindow = info.context?.contextWindow;
120
+ return { id, displayName: info.name, verification: 'unverified',
121
+ reasoningLevels: info.reasoning?.efforts?.map((effort) => effort.id) ?? [],
122
+ effortSource: 'catalog', imageIn: info.inputModalities?.includes('image') === true,
123
+ ...(Number.isSafeInteger(contextWindow) && contextWindow > 0 ? { contextWindow } : {}) };
124
+ }));
125
+ return { protocol, action: 'catalog', projectPath: project, configurationRevision: digest(JSON.stringify(entries)),
126
+ defaultModel: selection.model, models };
127
+ }
128
+ if (input.action === 'profile') {
129
+ const plugins = [];
130
+ const visit = (items, prefix = '') => {
131
+ for (const item of items) {
132
+ plugins.push({ id: prefix + item.id, name: item.name, enabled: item.disabled !== true });
133
+ if (Array.isArray(item.config?.plugins))
134
+ visit(item.config.plugins, prefix + item.id + '/');
135
+ if (item.group === true && Array.isArray(item.config))
136
+ visit(item.config, prefix + item.id + '/');
137
+ }
138
+ };
139
+ visit(composition.entries);
140
+ if (plugins.length > 512 || composition.excluded.length > 512 || composition.mcpServers.length > 64) {
141
+ throw new Error('DSH_PROFILE_LIMIT');
142
+ }
143
+ const servers = entries.find(entry => entry.id === 'mcp-manager')?.config?.servers ?? {};
144
+ return { protocol, action: 'profile', projectPath: project, configurationRevision: digest(JSON.stringify(entries)),
145
+ plugins, excluded: composition.excluded, mcpServers: composition.mcpServers.map(server => {
146
+ const config = servers[server.name];
147
+ let endpointOrigin;
148
+ try {
149
+ endpointOrigin = new URL(config.url).origin;
150
+ }
151
+ catch { /* Not an HTTP server. */ }
152
+ return { ...server, transport: config.transport,
153
+ ...(typeof config.command === 'string' ? { command: config.command } : {}),
154
+ argumentCount: Array.isArray(config.args) ? config.args.length : 0,
155
+ ...(endpointOrigin ? { endpointOrigin } : {}) };
156
+ }) };
157
+ }
158
+ if (!process.env.TMPDIR)
159
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
160
+ const storage = validateNativeStorage(composition.entries, { homePath: home, runtimePath: process.env.TMPDIR });
161
+ const definition = storage.entries.find(entry => entry.id === 'session-persistence-jsonl');
162
+ const root = storage.paths.sessions;
163
+ checkTree(root);
164
+ const configurationRevision = digest(JSON.stringify(entries));
165
+ const { Context } = await load('@deepseek-ai/cordis');
166
+ const plugin = await load('@deepseek-ai/dsh-session-persistence-jsonl');
167
+ const ctx = new Context();
168
+ let handle;
169
+ try {
170
+ await ctx.plugin(plugin, definition.config).await();
171
+ if (input.action === 'list') {
172
+ const snapshots = await ctx.sessionPersistence.list({ signal: AbortSignal.timeout(15000) });
173
+ if (!Array.isArray(snapshots) || snapshots.length > 16384)
174
+ throw new Error('DSH_SESSION_STORE_LIMIT');
175
+ const sessions = [];
176
+ for (const snapshot of snapshots) {
177
+ if (typeof snapshot.header?.cwd !== 'string' || canonical(snapshot.header.cwd) !== project)
178
+ continue;
179
+ const { id, agentPreset } = snapshot.header;
180
+ if (!/^[a-zA-Z0-9][a-zA-Z0-9._-]{0,255}$/.test(id)
181
+ || typeof agentPreset !== 'string' || !agentPreset || agentPreset.length > 256)
182
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
183
+ assertNativeStoragePath(snapshot.location?.path, root);
184
+ sessions.push({ nativeSessionId: id, projectPath: project, preset: agentPreset });
185
+ }
186
+ sessions.sort((a, b) => a.nativeSessionId.localeCompare(b.nativeSessionId));
187
+ return { protocol, action: 'list', projectPath: project, sessions: sessions.slice(input.offset, input.offset + 20),
188
+ nextOffset: input.offset + 20 < sessions.length ? input.offset + 20 : null };
189
+ }
190
+ const before = await ctx.sessionPersistence.stat(input.nativeSessionId);
191
+ if (!before)
192
+ throw new Error('DSH_SESSION_NOT_FOUND');
193
+ if (before.header.id !== input.nativeSessionId || canonical(before.header.cwd) !== project)
194
+ throw new Error('DSH_SESSION_PROJECT_MISMATCH');
195
+ if (!Number.isSafeInteger(before.sizeBytes) || before.sizeBytes > 64 * 1024 * 1024)
196
+ throw new Error('DSH_SESSION_STORE_LIMIT');
197
+ const file = assertNativeStoragePath(before.location?.path, root);
198
+ const fileVersion = () => {
199
+ const info = fs.statSync(assertNativeStoragePath(file, root), { bigint: true });
200
+ return digest(JSON.stringify([file, String(before.revision), configurationRevision,
201
+ String(info.dev), String(info.ino), String(info.size), String(info.mtimeNs), String(info.ctimeNs)]));
202
+ };
203
+ const version = fileVersion();
204
+ if (input.action === 'version')
205
+ return { protocol, action: 'version', nativeSessionId: input.nativeSessionId,
206
+ projectPath: project, version };
207
+ const hash = digest(fs.readFileSync(file));
208
+ // Opening a historical generation for write may migrate it. A fork must
209
+ // leave its source untouched; let the native app migrate it first.
210
+ const { SESSION_FORMAT_VERSION } = await load('@deepseek-ai/dsh-session');
211
+ if (['fork', 'discard-fork'].includes(input.action ?? '')
212
+ && ![`session.v${SESSION_FORMAT_VERSION}.jsonl`, `session.v${SESSION_FORMAT_VERSION}.jsonl.zstd`].includes(path.basename(file))) {
213
+ throw new Error('DSH_FORK_SOURCE_MIGRATION_REQUIRED');
214
+ }
215
+ // A mutation requires the native exclusive writer lease, including disposal.
216
+ try {
217
+ handle = await ctx.sessionPersistence.open(input.nativeSessionId, ['fork', 'discard-fork'].includes(input.action ?? '') ? 'write' : 'read');
218
+ }
219
+ catch (error) {
220
+ const { SessionAlreadyOwnedError } = await load('@deepseek-ai/dsh-session-persistence');
221
+ if (error instanceof SessionAlreadyOwnedError)
222
+ throw new Error('DSH_SESSION_BUSY');
223
+ throw error;
224
+ }
225
+ const { events } = await handle.read();
226
+ const after = await ctx.sessionPersistence.stat(input.nativeSessionId);
227
+ if (!after || before.revision !== after.revision || fileVersion() !== version || digest(fs.readFileSync(file)) !== hash)
228
+ throw new Error('DSH_SESSION_CHANGED');
229
+ const state = sessionState(events, input.allowActive);
230
+ const preset = handle.header.agentPreset;
231
+ if (typeof preset !== 'string' || !preset || preset.length > 256)
232
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
233
+ const observation = { protocol, nativeSessionId: handle.header.id, projectPath: project, preset,
234
+ eventCount: events.length, storageRevision: String(after.revision), configurationRevision,
235
+ fingerprint: digest(JSON.stringify([file, after.revision, hash, configurationRevision])),
236
+ state };
237
+ if (input.action === 'discard-fork') {
238
+ if (!handle.header.isSeeded || hash !== input.expectedFingerprint)
239
+ throw new Error('DSH_FORK_CHANGED');
240
+ // No native delete API exists. Only the exact, unchanged child created by this operation is removable.
241
+ // Keep its exclusive lease held through unlink so another writer cannot take ownership in between.
242
+ if (digest(fs.readFileSync(file)) !== hash)
243
+ throw new Error('DSH_FORK_CHANGED');
244
+ fs.unlinkSync(file);
245
+ return { protocol, nativeSessionId: input.nativeSessionId, discarded: true };
246
+ }
247
+ if (input.action === 'fork') {
248
+ if (observation.fingerprint !== input.expectedFingerprint)
249
+ throw new Error('DSH_SESSION_CHANGED');
250
+ const anchor = input.anchor === undefined ? undefined : Number(input.anchor.slice(4));
251
+ const target = anchor === undefined ? undefined : events.find((event) => event.seq === anchor
252
+ && ['user/message', 'assistant/message', 'tool/result'].includes(event.type));
253
+ if (anchor !== undefined && !target)
254
+ throw new Error('DSH_FORK_ANCHOR_INVALID');
255
+ const boundary = target?.seq ?? events.findLast((event) => event.type === 'turn/end')?.seq;
256
+ if (boundary === undefined)
257
+ throw new Error('DSH_FORK_EMPTY_SOURCE');
258
+ const { buildForkSeed } = await load('@deepseek-ai/dsh-session');
259
+ const seed = buildForkSeed(events, boundary);
260
+ // Use native inbox splice events to cancel inherited work, as Inbox.clear does.
261
+ const pending = { 'next-step': 0, 'next-turn': 0 };
262
+ for (const event of seed)
263
+ if (event.type === 'agent/inbox/spliced') {
264
+ const { target: queue, start, removedCount = 0, inserted } = event.data;
265
+ if (!(queue in pending) || !Array.isArray(inserted) || start < 0 || start + removedCount > pending[queue]) {
266
+ throw new Error('DSH_FORK_INBOX_INVALID');
267
+ }
268
+ pending[queue] += inserted.length - removedCount;
269
+ }
270
+ for (const queue of ['next-step', 'next-turn'])
271
+ if (pending[queue])
272
+ seed.push({
273
+ seq: seed.length, time: Date.now(), type: 'agent/inbox/spliced',
274
+ data: { target: queue, start: 0, removedCount: pending[queue], inserted: [], outcome: 'canceled' },
275
+ });
276
+ const child = await ctx.sessionPersistence.create({ version: handle.header.version, id: input.childId,
277
+ createdAt: Date.now(), cwd: project, isSeeded: true, agentPreset: preset }, { inheritedEventCount: boundary + 1 });
278
+ try {
279
+ await child.append(seed);
280
+ await child.flush();
281
+ }
282
+ catch (error) {
283
+ try {
284
+ const failed = await ctx.sessionPersistence.stat(input.childId);
285
+ if (failed?.location?.path)
286
+ fs.unlinkSync(assertNativeStoragePath(failed.location.path, root));
287
+ }
288
+ finally {
289
+ await child.close();
290
+ }
291
+ throw error;
292
+ }
293
+ await child.close();
294
+ const created = await ctx.sessionPersistence.stat(input.childId);
295
+ const childPath = assertNativeStoragePath(created?.location?.path, root);
296
+ return { protocol, nativeSessionId: input.childId, fingerprint: digest(fs.readFileSync(childPath)) };
297
+ }
298
+ if (input.action === 'history') {
299
+ if (input.offset > events.length)
300
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
301
+ return { ...observation, action: 'history', offset: input.offset, events: historyPage(events, input.offset) };
302
+ }
303
+ if (input.action === 'history-all')
304
+ return { ...observation, action: 'history-all', version, events };
305
+ return observation;
306
+ }
307
+ finally {
308
+ try {
309
+ await handle?.close();
310
+ }
311
+ finally {
312
+ await ctx.fiber.dispose();
313
+ }
314
+ }
315
+ }
316
+ async function main() {
317
+ const stream = fs.createReadStream('', { fd: 3, autoClose: true });
318
+ const timer = setTimeout(() => stream.destroy(new Error('DSH_SESSION_INSPECTION_TIMEOUT')), 10000);
319
+ try {
320
+ const chunks = [];
321
+ let size = 0;
322
+ for await (const chunk of stream) {
323
+ if ((size += chunk.length) > 64 * 1024)
324
+ throw new Error('DSH_SESSION_INSPECTION_INVALID');
325
+ chunks.push(chunk);
326
+ }
327
+ const result = await inspectNativeSession(JSON.parse(Buffer.concat(chunks).toString('utf8')));
328
+ process.stdout.write(JSON.stringify(result) + '\n');
329
+ }
330
+ catch (error) {
331
+ const code = error instanceof Error && /^DSH_[A-Z_]+$/.test(error.message) ? error.message : 'DSH_SESSION_INSPECTION_FAILED';
332
+ process.stdout.write(JSON.stringify({ protocol, error: code }) + '\n');
333
+ process.exitCode = 1;
334
+ }
335
+ finally {
336
+ clearTimeout(timer);
337
+ }
338
+ }
339
+ if (process.argv[1] && import.meta.url === pathToFileURL(path.resolve(process.argv[1])).href)
340
+ await main();
@@ -0,0 +1,49 @@
1
+ export function nativeSkillPolicy(value) {
2
+ if (value === undefined)
3
+ return { enabled: true, mode: 'inherit', overrides: {} };
4
+ const policy = value;
5
+ if (!policy || typeof policy !== 'object' || Array.isArray(policy)
6
+ || typeof policy.enabled !== 'boolean' || !['all', 'none', 'inherit'].includes(policy.mode)
7
+ || !policy.overrides || typeof policy.overrides !== 'object' || Array.isArray(policy.overrides)
8
+ || Object.keys(policy).some(key => !['enabled', 'mode', 'overrides'].includes(key))
9
+ || Object.entries(policy.overrides).some(([name, status]) => !name || !['enabled', 'disabled'].includes(status))) {
10
+ throw new Error('DSH_NATIVE_SKILL_POLICY_INVALID');
11
+ }
12
+ return { enabled: policy.enabled, mode: policy.mode, overrides: { ...policy.overrides } };
13
+ }
14
+ export function nativeSkillEnabled(policy, name) {
15
+ return policy.enabled && (Object.hasOwn(policy.overrides, name)
16
+ ? policy.overrides[name] === 'enabled' : policy.mode !== 'none');
17
+ }
18
+ export function nativeToolSupported(name) {
19
+ return ['read', 'read_image', 'write', 'edit', 'ask_user_question', 'skill', 'web_search', 'web_fetch',
20
+ process.platform === 'win32' ? 'pwsh' : 'bash',
21
+ 'list_mcp_resources', 'list_mcp_resource_templates', 'read_mcp_resource'].includes(name)
22
+ || name.startsWith('mcp__');
23
+ }
24
+ /** Filter live native discovery and loading; never copy or persist skill bodies. */
25
+ export function filterNativeSkills(registry, policy) {
26
+ const snapshotDescriptor = Object.getOwnPropertyDescriptor(registry, 'snapshot');
27
+ const getDescriptor = Object.getOwnPropertyDescriptor(registry, 'get');
28
+ const snapshot = registry.snapshot.bind(registry);
29
+ const get = registry.get.bind(registry);
30
+ registry.snapshot = async (options) => {
31
+ const result = await snapshot(options);
32
+ return { ...result, skills: result.skills.filter((skill) => nativeSkillEnabled(policy, skill.name)) };
33
+ };
34
+ registry.get = async (name, options) => nativeSkillEnabled(policy, name) ? get(name, options) : undefined;
35
+ let restored = false;
36
+ return () => {
37
+ if (restored)
38
+ return;
39
+ restored = true;
40
+ if (snapshotDescriptor)
41
+ Object.defineProperty(registry, 'snapshot', snapshotDescriptor);
42
+ else
43
+ delete registry.snapshot;
44
+ if (getDescriptor)
45
+ Object.defineProperty(registry, 'get', getDescriptor);
46
+ else
47
+ delete registry.get;
48
+ };
49
+ }
@@ -0,0 +1,145 @@
1
+ /** Read-only metadata from the authorized native DSH persistence API. */
2
+ import fs from 'node:fs';
3
+ import { createHash } from 'node:crypto';
4
+ import { sanitizeSessionTitle } from '../../core/session/session-title.js';
5
+ import { DshNativeResourceRegistry } from './resources.js';
6
+ import { dshNativeSessionInspector } from './resources.js';
7
+ function canonicalSessionPath(file) {
8
+ const resolved = fs.realpathSync(file);
9
+ return process.platform === 'win32' ? resolved.toLowerCase() : resolved;
10
+ }
11
+ /** Only an idle, unbound DSH conversation with its Owner may acquire native history. */
12
+ export function validateDshEcSession(session, agentAid, ownerAid, projectPath, access) {
13
+ if (!session || session.selfAID !== agentAid || session.channelType !== 'aun'
14
+ || session.channelId !== ownerAid || session.chatType !== 'private' || session.deletedAt
15
+ || session.topicStatus === 'archived' || (session.sessionType && session.sessionType !== 'main')
16
+ || session.baseagent !== 'dsh' || session.agentSessionId)
17
+ throw new Error('DSH_EC_SESSION_INELIGIBLE');
18
+ if (session.processingState || session.metadata?.turnState?.active || access.isBusy(session))
19
+ throw new Error('DSH_EC_SESSION_BUSY');
20
+ if (canonicalSessionPath(session.projectPath) !== canonicalSessionPath(projectPath))
21
+ throw new Error('DSH_EC_SESSION_PROJECT_MISMATCH');
22
+ return createHash('sha256').update(JSON.stringify([session.id, session.selfAID, session.channel,
23
+ session.channelId, session.baseagent, canonicalSessionPath(session.projectPath), session.updatedAt])).digest('hex');
24
+ }
25
+ /** A resource grant alone cannot expose history: a current Agent-specific session grant is also required. */
26
+ export async function readDshNativeHistory(agentAid, nativeSessionId, projectPath, signal, options) {
27
+ signal?.throwIfAborted();
28
+ const registry = new DshNativeResourceRegistry();
29
+ const binding = await registry.findNativeSession(agentAid, nativeSessionId, projectPath);
30
+ if (!binding)
31
+ return undefined;
32
+ const registration = await registry.resolve(agentAid, binding.nativeResourceId, binding.registrationRevision);
33
+ const events = [];
34
+ let fingerprint;
35
+ let count = 0;
36
+ do {
37
+ signal?.throwIfAborted();
38
+ await registry.resolveSession(agentAid, binding.ecSessionId, binding.revision);
39
+ const page = await dshNativeSessionInspector.history(registration, nativeSessionId, binding.projectPath, events.length, signal, options?.allowActive);
40
+ if (fingerprint && (page.fingerprint !== fingerprint || page.eventCount !== count))
41
+ throw new Error('DSH_SESSION_CHANGED');
42
+ fingerprint = page.fingerprint;
43
+ count = page.eventCount;
44
+ if (count > 1000000)
45
+ throw new Error('DSH_SESSION_STORE_LIMIT');
46
+ events.push(...page.events);
47
+ } while (events.length < count);
48
+ await registry.resolveSession(agentAid, binding.ecSessionId, binding.revision);
49
+ const final = await dshNativeSessionInspector.inspect(registration, nativeSessionId, binding.projectPath, options?.allowActive, signal);
50
+ signal?.throwIfAborted();
51
+ if (final.fingerprint !== fingerprint)
52
+ throw new Error('DSH_SESSION_CHANGED');
53
+ await registry.resolveSession(agentAid, binding.ecSessionId, binding.revision);
54
+ return events;
55
+ }
56
+ // ECWeb can reuse a verified snapshot while the native file and its configuration
57
+ // are unchanged. Authorization and the session binding are checked on every call.
58
+ const viewHistoryCache = new Map();
59
+ const VIEW_CACHE_BYTES = 64 * 1024 * 1024;
60
+ export async function readDshNativeHistoryForView(agentAid, nativeSessionId, projectPath, signal) {
61
+ signal?.throwIfAborted();
62
+ const registry = new DshNativeResourceRegistry();
63
+ const binding = await registry.findNativeSession(agentAid, nativeSessionId, projectPath);
64
+ if (!binding)
65
+ return undefined;
66
+ const registration = await registry.resolve(agentAid, binding.nativeResourceId, binding.registrationRevision);
67
+ const key = JSON.stringify([agentAid, nativeSessionId, binding.ecSessionId, binding.revision,
68
+ binding.registrationRevision, binding.projectPath]);
69
+ const cached = viewHistoryCache.get(key);
70
+ let events;
71
+ let version;
72
+ if (cached && await dshNativeSessionInspector.version(registration, nativeSessionId, binding.projectPath, signal) === cached.version) {
73
+ events = cached.events;
74
+ version = cached.version;
75
+ }
76
+ else {
77
+ viewHistoryCache.delete(key);
78
+ ({ events, version } = await dshNativeSessionInspector.historyAll(registration, nativeSessionId, binding.projectPath, signal));
79
+ }
80
+ await registry.resolveSession(agentAid, binding.ecSessionId, binding.revision);
81
+ signal?.throwIfAborted();
82
+ viewHistoryCache.delete(key);
83
+ const bytes = cached?.events === events ? cached.bytes : Buffer.byteLength(JSON.stringify(events));
84
+ if (bytes <= VIEW_CACHE_BYTES) {
85
+ viewHistoryCache.set(key, { events, version, bytes });
86
+ let total = [...viewHistoryCache.values()].reduce((sum, entry) => sum + entry.bytes, 0);
87
+ while (total > VIEW_CACHE_BYTES || viewHistoryCache.size > 4) {
88
+ const oldest = viewHistoryCache.keys().next().value;
89
+ if (oldest === undefined)
90
+ break;
91
+ total -= viewHistoryCache.get(oldest).bytes;
92
+ viewHistoryCache.delete(oldest);
93
+ }
94
+ }
95
+ return events;
96
+ }
97
+ function addEvent(summary, event) {
98
+ if (event.type === 'turn/start')
99
+ summary.turns++;
100
+ if (event.type !== 'user/message' || event.data?.source?.kind === 'runtime-context')
101
+ return;
102
+ const content = event.data?.content;
103
+ const text = typeof content === 'string' ? content : Array.isArray(content)
104
+ ? content.filter(block => block?.type === 'text' && typeof block.text === 'string')
105
+ .map(block => block.text).join('\n') : '';
106
+ const preview = sanitizeSessionTitle(text);
107
+ if (preview) {
108
+ summary.firstMessage ??= preview;
109
+ summary.lastMessage = preview;
110
+ }
111
+ }
112
+ export class DshSessionFileAdapter {
113
+ baseagent = 'dsh';
114
+ // Native reads require asynchronous authorization. Synchronous checks cannot
115
+ // establish deletion, so Core must preserve the binding for the Runner to validate.
116
+ checkStatus(_projectPath, _agentSessionId, _agentAid) { return 'unavailable'; }
117
+ checkExists(_projectPath, _agentSessionId, _agentAid) { return false; }
118
+ getFileInfo(_projectPath, _agentSessionId, _agentAid) { return { turns: 0 }; }
119
+ readFirstMessage(_projectPath, _agentSessionId, _agentAid) { return null; }
120
+ readLastUserMessage(_projectPath, _agentSessionId, _agentAid) { return null; }
121
+ async readSummary(projectPath, agentSessionId, agentAid) {
122
+ const summary = { turns: 0, firstMessage: null, lastMessage: null };
123
+ if (!agentAid)
124
+ return summary;
125
+ const events = await readDshNativeHistory(agentAid, agentSessionId, projectPath);
126
+ if (events)
127
+ for (const event of events)
128
+ addEvent(summary, event);
129
+ return summary;
130
+ }
131
+ async getFileInfoAsync(projectPath, agentSessionId, agentAid) {
132
+ const summary = await this.readSummary(projectPath, agentSessionId, agentAid);
133
+ return { turns: summary.turns, title: summary.firstMessage ?? undefined };
134
+ }
135
+ async readMenuSummary(projectPath, agentSessionId, agentAid) {
136
+ const summary = await this.readSummary(projectPath, agentSessionId, agentAid);
137
+ return { turns: summary.turns, firstMessage: summary.firstMessage };
138
+ }
139
+ async readLastUserMessageAsync(projectPath, agentSessionId, agentAid) {
140
+ return (await this.readSummary(projectPath, agentSessionId, agentAid)).lastMessage;
141
+ }
142
+ scanCliSessions(_projectPath, _limit, _agentAid) {
143
+ return [];
144
+ }
145
+ }