@waq666/pneuma 0.0.0-stage → 0.7.1

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 (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,104 @@
1
+ /**
2
+ * dock 通道的分档规格:读类 / 写类 / 终端。
3
+ *
4
+ * ## 为什么要分档
5
+ *
6
+ * `dock` 原来是**整条**被界面通道排除的,理由是它里面混着 `term-spawn`(起 pwsh/cmd/bash/node)——
7
+ * 那与「在用户机器上执行任意命令」同级,不该交给页面。但这条通道里另外十一个 op 是界面真正要用的:
8
+ * 工作区文件树、文件内容、git 状态与分支清单、差异(读),以及暂存 / 取消暂存 / 提交 /
9
+ * 切分支 / 建分支(写)。
10
+ * 一锅端掉等于「文件面板」永远搬不进壳;整条放行又等于把 spawn 交出去。所以按**动作落在谁手里**拆三档:
11
+ *
12
+ * | 档 | op | 走哪条路 | 为什么 |
13
+ * | --- | --- | --- | --- |
14
+ * | 读 | `fs-list` `fs-read` `git-status` `git-branches` `git-log` `git-diff` | 界面 HTTP 通道**直接放行** | 只读,且宿主侧已经限定在 cwd 内 |
15
+ * | 写 | `git-stage` `git-unstage` `git-commit` `git-checkout` `git-branch-create` | 界面 HTTP 通道,但**过审批** | 会改仓库状态,交给权限模式那套裁决(与工具调用同一口径) |
16
+ * | 终端 | `term-spawn` `term-input` `term-kill` | **只走桌面窗口的原生桥**,不进 HTTP 面 | 起进程 = 任意命令执行;浏览器里拿到 Cookie 的页面不该有这个能力 |
17
+ *
18
+ * 「只走原生桥」是**真的**只走那条路:`DOCK_UI_OPS` 里没有 term op,所以 HTTP 的
19
+ * `/api/invoke { method: 'dock' }` 拿着 `term-spawn` 会被实参校验当场拒(枚举不在表里)。
20
+ * 而原生桥只对主窗口的文档开放(`event.sender === mainWindow.webContents`),
21
+ * 于是"桌面窗口有效"这件事由**传输**保证,而不是靠 payload 里一个可伪造的标记位。
22
+ *
23
+ * 这一份零依赖、浏览器安全,所以三处共用:宿主插件(分档与审批)、界面通道(放行面)、
24
+ * 桌面主进程与壳(终端那条路)。
25
+ *
26
+ * @module dsc/core/dock-ops
27
+ */
28
+ /** 读类:只读取工作区现状,宿主侧限定在 cwd 内。 */
29
+ export const DOCK_READ_OPS = ['fs-list', 'fs-read', 'git-status', 'git-branches', 'git-log', 'git-diff'];
30
+ /** 写类:会改 git 状态,走审批。 */
31
+ export const DOCK_WRITE_OPS = [
32
+ 'git-stage',
33
+ 'git-unstage',
34
+ 'git-commit',
35
+ 'git-checkout',
36
+ 'git-branch-create',
37
+ ];
38
+ /** 终端:起进程,只走桌面窗口的原生桥。 */
39
+ export const DOCK_TERM_OPS = ['term-spawn', 'term-input', 'term-kill'];
40
+ /** 全部 op(宿主插件按它认人)。 */
41
+ export const DOCK_OPS = [...DOCK_READ_OPS, ...DOCK_WRITE_OPS, ...DOCK_TERM_OPS];
42
+ /** 界面 HTTP 通道放行的 op:读 + 写,**没有**终端。 */
43
+ export const DOCK_UI_OPS = [...DOCK_READ_OPS, ...DOCK_WRITE_OPS];
44
+ /** 查表用的集合。 */
45
+ export const DOCK_TERM_OP_SET = new Set(DOCK_TERM_OPS);
46
+ export const DOCK_WRITE_OP_SET = new Set(DOCK_WRITE_OPS);
47
+ /** 是不是终端 op(决定它能不能进界面 HTTP 面)。 */
48
+ export function isDockTermOp(op) {
49
+ return DOCK_TERM_OP_SET.has(op);
50
+ }
51
+ /** 是不是写类 op(决定要不要过审批)。 */
52
+ export function isDockWriteOp(op) {
53
+ return DOCK_WRITE_OP_SET.has(op);
54
+ }
55
+ /**
56
+ * 写类 op 的审批卡文案。
57
+ *
58
+ * `toolName` 用 `git:` 前缀,一眼能跟工具调用区分开(审批卡上会显示这一栏);
59
+ * `summary` 只放**这次要动什么**(文件清单 / 提交信息首行),不放整段 payload——
60
+ * 卡片是单行的,塞不下。
61
+ */
62
+ export const DOCK_WRITE_LABEL = {
63
+ 'git-stage': {
64
+ toolName: 'git: 暂存',
65
+ summary: (payload) => `暂存 ${fileListText(payload)}`,
66
+ },
67
+ 'git-unstage': {
68
+ toolName: 'git: 取消暂存',
69
+ summary: (payload) => `取消暂存 ${fileListText(payload)}`,
70
+ },
71
+ 'git-commit': {
72
+ toolName: 'git: 提交',
73
+ summary: (payload) => `提交:${firstLine(String(payload['message'] ?? ''))}`,
74
+ },
75
+ // 切分支与建分支都动**工作树**(切过去会把当前分支上未提交、且两边不一致的改动带过去
76
+ // 或被 git 拒掉),所以与提交同档:过审批,卡片上直接写清切到哪个分支。
77
+ 'git-checkout': {
78
+ toolName: 'git: 切换分支',
79
+ summary: (payload) => `切到 ${branchName(payload)}`,
80
+ },
81
+ 'git-branch-create': {
82
+ toolName: 'git: 新建并切换分支',
83
+ summary: (payload) => `新建并切到 ${branchName(payload)}`,
84
+ },
85
+ };
86
+ /** 分支名的短文案(两个新写类 op 共用;缺失时说清「没给名字」而不是留空)。 */
87
+ function branchName(payload) {
88
+ const name = String(payload['branch'] ?? payload['name'] ?? '').trim();
89
+ return name === '' ? '(没有指定分支名)' : name;
90
+ }
91
+ /** 文件清单的短文案:最多三个名字,其余收成「等 N 个」。 */
92
+ function fileListText(payload) {
93
+ const files = Array.isArray(payload['files']) ? payload['files'] : [];
94
+ const names = files.filter((file) => typeof file === 'string').slice(0, 3);
95
+ if (names.length === 0)
96
+ return '(没有指定文件)';
97
+ const rest = files.length - names.length;
98
+ return rest > 0 ? `${names.join('、')} 等 ${String(files.length)} 个文件` : names.join('、');
99
+ }
100
+ /** 取第一行并压到 80 字(提交信息可能是一整段)。 */
101
+ function firstLine(text) {
102
+ const line = text.split('\n', 1)[0] ?? '';
103
+ return line.length > 80 ? `${line.slice(0, 80)}…` : line;
104
+ }
@@ -0,0 +1,39 @@
1
+ /**
2
+ * 把一台 dock 视图包成 {@link CdpCommandTarget}——`src/core/cdp/` 那套快照/动作在
3
+ * **没有 WebSocket 后端**时的接入点。
4
+ *
5
+ * 为什么单独一个文件:dock 视图(侧栏那台 `WebContentsView`)不是一条
6
+ * `--remote-debugging-port` 的 WebSocket 连接,命令要经宿主协议转给桌面主进程,
7
+ * 由那边的 `webContents.debugger` 执行。抽成一个**纯工厂**(不 import electron、
8
+ * 不 import 任何有副作用的东西,只依赖调用方传进来的 `source`)之后:
9
+ * 1. `src/core/cdp/{actions,snapshot}` 那两层对后端无感地复用同一份逻辑;
10
+ * 2. 探针能用类型擦除直读这个模块、喂一个假 `source` 就验证「命令有没有按视图路由、
11
+ * 事件有没有按视图过滤」——不必起一个真桌面壳。
12
+ *
13
+ * 一句话:**逻辑在这里、传输在外面**。路由与过滤是纯计算,所以可直测,
14
+ * 也不会因为宿主环境(真 Electron / 手测)不同而行为不同。
15
+ *
16
+ * @module dsc/core/dock-session
17
+ */
18
+ import type { CdpCommandTarget } from './cdp/transport.js';
19
+ import type { DockBrowserEventPush } from './dock-browser.js';
20
+ /**
21
+ * dock 会话的后端:宿主链路门面(`HostBrowserLink`)满足这个形状。
22
+ *
23
+ * 刻意只取 `call` 与 `onEvent` 两件事,而不是整份 `HostBrowserLink`——
24
+ * 这条会话只关心「在哪台视图上发哪条命令、订哪条事件」,可用性判定与页签开户
25
+ * 属于门面自己要管的事,不该渗进这一层。
26
+ */
27
+ export interface DockSessionSource {
28
+ /** 在某台视图上执行一条 CDP 命令,返回 CDP 原文的 `value`。 */
29
+ call<T = unknown>(viewId: string, method: string, params?: Record<string, unknown>): Promise<T>;
30
+ /** 订全局的 CDP 事件推送(本侧订阅者集合,返回退订函数)。 */
31
+ onEvent(handler: (event: DockBrowserEventPush) => void): () => void;
32
+ }
33
+ /**
34
+ * 把一台 dock 视图包成一条 CDP 会话。
35
+ *
36
+ * @param source - 真正把命令送出去的宿主链路({@link DockSessionSource})。
37
+ * @param viewId - 桌面侧编的视图 id;`sessionId` 就是它,桌面按它路由到对应 webContents。
38
+ */
39
+ export declare function createDockSession(source: DockSessionSource, viewId: string): CdpCommandTarget;
@@ -0,0 +1,28 @@
1
+ /**
2
+ * 把一台 dock 视图包成一条 CDP 会话。
3
+ *
4
+ * @param source - 真正把命令送出去的宿主链路({@link DockSessionSource})。
5
+ * @param viewId - 桌面侧编的视图 id;`sessionId` 就是它,桌面按它路由到对应 webContents。
6
+ */
7
+ export function createDockSession(source, viewId) {
8
+ return {
9
+ // sessionId 用视图 id:桌面侧的 debugger 已经挂在这一台上,命令按它找目标。
10
+ sessionId: viewId,
11
+ send(method, params) {
12
+ // 直接透传:视图 id 由本会话固定,action 层不必每次再写一遍。
13
+ return source.call(viewId, method, params);
14
+ },
15
+ on(method, handler) {
16
+ // 一条 source 上挂着所有订阅者,事件推来时按 viewId + method **双重过滤**:
17
+ // 只有属于这一台视图、且是订阅者关心的那一条,才投给它。
18
+ // 不过滤的话,两台视图上同名的 `Runtime.consoleAPICalled` 会串台。
19
+ return source.onEvent((event) => {
20
+ if (event.viewId !== viewId)
21
+ return;
22
+ if (event.method !== method)
23
+ return;
24
+ handler(event.params);
25
+ });
26
+ },
27
+ };
28
+ }
@@ -0,0 +1,18 @@
1
+ /** initialize(data) 收到的形状。 */
2
+ interface HookData {
3
+ /** dsc 运行时根目录(package.json 所在处;自带 node_modules 的解析起点)。 */
4
+ runtimeRoot: string;
5
+ /** 允许重定向的插件目录(file URL 前缀)。 */
6
+ pluginsRoots: string[];
7
+ }
8
+ export declare function initialize(hookData: HookData): Promise<void>;
9
+ export declare function resolve(specifier: string, context: {
10
+ parentURL?: string | undefined;
11
+ }, nextResolve: (specifier: string, context?: unknown) => Promise<{
12
+ url: string;
13
+ shortCircuit?: boolean;
14
+ }>): Promise<{
15
+ url: string;
16
+ shortCircuit?: boolean;
17
+ }>;
18
+ export {};
@@ -0,0 +1,52 @@
1
+ /**
2
+ * dsh 兼容层的模块解析钩子(Node `module.register` 的 hooks 侧)。
3
+ *
4
+ * dsh 外部插件以裸说明符 import dsh 生态的库(`@deepseek-ai/dsh-tools` 的
5
+ * defineTool、`@deepseek-ai/schemastery` 的 z……)。这些文件装在 `~/.dsc/plugins/`
6
+ * 下,Node 的解析走不到 dsc 自带的 node_modules。本钩子只做一件事:
7
+ * 当**导入方在插件目录里**且说明符以 `@deepseek-ai/` 开头时,改用 dsc 运行时的
8
+ * node_modules(以及 dsh-tools 自身的真实目录,pnpm 的传递依赖在那里)按 ESM
9
+ * 条件重新解析。双构建包(schemastery 这类)因此会命中与 dsh-tools 内部 import
10
+ * 完全相同的文件,不会出现 CJS/ESM 双实例的 instanceof 分裂。
11
+ *
12
+ * 本文件会被装进 hooks 专用线程执行:不要 import dsc 的任何模块、不要保存主线程状态。
13
+ *
14
+ * @module dsc/core/dsh-compat/hook
15
+ */
16
+ import { createRequire } from 'node:module';
17
+ import { join } from 'node:path';
18
+ import { pathToFileURL } from 'node:url';
19
+ let data = null;
20
+ /** 两个解析基点:dsc 根目录(直接依赖:cordis、dsh-tools);dsh-tools 真实目录(传递依赖)。 */
21
+ let bases = [];
22
+ export async function initialize(hookData) {
23
+ data = hookData;
24
+ bases = [hookData.runtimeRoot];
25
+ // dsh-tools 的传递依赖(schemastery、dsh-brand、dsh-util-values)住在它自己的
26
+ // node_modules 兄弟位(pnpm 布局);用 realpath 保证符号链接下也走对目录。
27
+ try {
28
+ const requireFromRuntime = createRequire(join(hookData.runtimeRoot, 'package.json'));
29
+ bases.push(join(requireFromRuntime.resolve('@deepseek-ai/dsh-tools'), '..'));
30
+ }
31
+ catch {
32
+ // 没装 dsh-tools 就只剩 dsc 根目录一个基点:插件 import 时会响亮失败
33
+ }
34
+ }
35
+ export async function resolve(specifier, context, nextResolve) {
36
+ const parent = context.parentURL ?? '';
37
+ if (data !== null &&
38
+ specifier.startsWith('@deepseek-ai/') &&
39
+ parent.startsWith('file:') &&
40
+ data.pluginsRoots.some((root) => parent.startsWith(root))) {
41
+ for (const base of bases) {
42
+ try {
43
+ // 借基点目录当 parent:裸说明符解析只用目录做向上查走,假文件名不要求存在
44
+ return await nextResolve(specifier, { ...context, parentURL: pathToFileURL(join(base, 'package.json')).href });
45
+ }
46
+ catch {
47
+ // 换下一个基点;全失败就走默认解析(ERR_MODULE_NOT_FOUND,响亮)
48
+ }
49
+ }
50
+ }
51
+ return nextResolve(specifier, context);
52
+ }
@@ -0,0 +1,5 @@
1
+ /**
2
+ * 注册解析钩子(幂等)。
3
+ * @param pluginsRoots - 允许重定向的插件目录(`~/.dsc/plugins/`)。
4
+ */
5
+ export declare function ensureResolveHook(pluginsRoots: string[]): void;
@@ -0,0 +1,59 @@
1
+ /**
2
+ * dsh 兼容层的模块解析钩子(主线程,同步注册)。
3
+ *
4
+ * dsh 外部插件以裸说明符 import dsh 生态的库(`@deepseek-ai/dsh-tools` 的
5
+ * defineTool、`@deepseek-ai/schemastery` 的 z……)。这些文件装在 `~/.dsc/plugins/`
6
+ * 下,Node 的解析走不到 dsc 自带的 node_modules。本钩子只做一件事:
7
+ * 当**导入方在插件目录里**且说明符以 `@deepseek-ai/` 开头时,改用 dsc 运行时的
8
+ * node_modules(以及 dsh-tools 自身的真实目录,pnpm 的传递依赖在那里)按 ESM
9
+ * 条件重新解析。双构建包(schemastery 这类)因此会命中与 dsh-tools 内部 import
10
+ * 完全相同的文件,不会出现 CJS/ESM 双实例的 instanceof 分裂。
11
+ *
12
+ * 用 `registerHooks`(同步、本线程)而不是 `register`(异步、hooks 线程):
13
+ * 注册完成即可生效,挂载路径不必等钩子线程就绪,也没有跨线程状态要传。
14
+ *
15
+ * @module dsc/core/dsh-compat/resolve-hook
16
+ */
17
+ import { registerHooks, createRequire } from 'node:module';
18
+ import { join } from 'node:path';
19
+ import { fileURLToPath, pathToFileURL } from 'node:url';
20
+ let registered = false;
21
+ /**
22
+ * 注册解析钩子(幂等)。
23
+ * @param pluginsRoots - 允许重定向的插件目录(`~/.dsc/plugins/`)。
24
+ */
25
+ export function ensureResolveHook(pluginsRoots) {
26
+ if (registered)
27
+ return;
28
+ registered = true;
29
+ // 解析基点:dsc 根目录(直接依赖:cordis、dsh-tools);dsh-tools 的真实目录
30
+ // (它的传递依赖 schemastery、dsh-brand、dsh-util-values 住在 pnpm 布局的兄弟位)。
31
+ const runtimeRoot = fileURLToPath(new URL('../..', import.meta.url));
32
+ const bases = [runtimeRoot];
33
+ try {
34
+ bases.push(join(createRequire(join(runtimeRoot, 'package.json')).resolve('@deepseek-ai/dsh-tools'), '..'));
35
+ }
36
+ catch {
37
+ // 没装 dsh-tools 就只剩 dsc 根目录一个基点:插件 import 时会响亮失败
38
+ }
39
+ const roots = pluginsRoots.map((root) => `${pathToFileURL(root).href}/`);
40
+ registerHooks({
41
+ resolve(specifier, context, nextResolve) {
42
+ const parent = context.parentURL ?? '';
43
+ if (specifier.startsWith('@deepseek-ai/') &&
44
+ parent.startsWith('file:') &&
45
+ roots.some((root) => parent.startsWith(root))) {
46
+ for (const base of bases) {
47
+ try {
48
+ // 借基点目录当 parent:裸说明符解析只用目录做向上查走,假文件名不要求存在
49
+ return nextResolve(specifier, { ...context, parentURL: pathToFileURL(join(base, 'package.json')).href });
50
+ }
51
+ catch {
52
+ // 换下一个基点;全失败就走默认解析(ERR_MODULE_NOT_FOUND,响亮)
53
+ }
54
+ }
55
+ }
56
+ return nextResolve(specifier, context);
57
+ },
58
+ });
59
+ }
@@ -0,0 +1,47 @@
1
+ /**
2
+ * dsh 工具定义 → dsc 工具条目的适配面(兼容层唯一认识 dsh 工具形状的地方)。
3
+ *
4
+ * dsh 的 ToolDefinition(`defineTool` 的产物)与 dsc 的 ToolEntry 在参数 schema 上
5
+ * 同构(都是 JSON Schema 对象),差异在执行侧:
6
+ * dsh execute(args, exec) 返回「规范 JSON 值」,模型可见内容由 output.render 投影;
7
+ * dsc run(args, ctx) 直接返回文本 / 文本+图像。
8
+ * 适配层把 exec 缩成 dsc 拿得到的那两样(signal / cwd),把 render 的内容块折成文本;
9
+ * risk 不是 dsh 概念,缺省 'exec'(每次都过审批卡),可被插件条目配置覆盖。
10
+ *
11
+ * @module dsc/core/dsh-compat/tools-facade
12
+ */
13
+ import type { ToolEntry } from '../tools.js';
14
+ /** dsh ToolDefinition 里兼容层认得的字段(其余字段照原样被忽略)。 */
15
+ export interface DshToolDefinitionLike {
16
+ name: unknown;
17
+ description: unknown;
18
+ parameters: unknown;
19
+ execute?: unknown;
20
+ /** dsh 规定必填;兼容层对缺了它的定义容错(跳过投影直接字符串化)。 */
21
+ output?: {
22
+ render?: unknown;
23
+ } | unknown;
24
+ timeoutMs?: unknown;
25
+ }
26
+ /** 插件条目树里关于 risk 的配置形状(值来自 JSON,宽松收进来再收敛)。 */
27
+ export interface DshRiskConfig {
28
+ /** 这份插件所有工具的缺省 risk。 */
29
+ risk?: unknown;
30
+ /** 按工具名覆盖。 */
31
+ risks?: Record<string, unknown>;
32
+ }
33
+ /** 判一个对象像不像 dsh 的 ToolDefinition(有 execute、没有 dsc 的 run)。 */
34
+ export declare function looksLikeDshToolDefinition(candidate: unknown): candidate is DshToolDefinitionLike;
35
+ /**
36
+ * 把一个 dsh ToolDefinition 包成 dsc ToolEntry。转出来的工具:
37
+ * - 参数 schema 原样透传(两边同是 JSON Schema,llm 层怎么发就怎么发);
38
+ * - execute 收到的 exec 只保证有 `signal`(dsc 的执行上下文没有 agent 身份那些字段);
39
+ * - 声明了 timeoutMs 时到点放弃等待(协作式的:工具内部自己看 signal 才是真取消)。
40
+ */
41
+ export declare function dshToolToEntry(definition: DshToolDefinitionLike, config: DshRiskConfig): ToolEntry;
42
+ /**
43
+ * dsh `ctx.tools` 的兼容面:register 收 dsh ToolDefinition,其余成员一律响亮报错——
44
+ * 静默装作支持只会让插件在更深处莫名坏掉。risk 映射每次注册时经 readConfig 现读,
45
+ * 插件条目配置里改 risk 不必重挂。
46
+ */
47
+ export declare function dshToolsFacade(register: (entry: ToolEntry) => () => void, readConfig: () => DshRiskConfig): unknown;
@@ -0,0 +1,108 @@
1
+ const RISKS = new Set(['read', 'write', 'exec']);
2
+ /** 判一个对象像不像 dsh 的 ToolDefinition(有 execute、没有 dsc 的 run)。 */
3
+ export function looksLikeDshToolDefinition(candidate) {
4
+ if (candidate === null || typeof candidate !== 'object')
5
+ return false;
6
+ const record = candidate;
7
+ return typeof record.name === 'string' && typeof record.execute === 'function' && typeof record.run !== 'function';
8
+ }
9
+ /** 把配置里的 risk 字样收敛成合法值;认不出就落回 'exec'(多问一次总比漏问强)。 */
10
+ function normalizeRisk(raw) {
11
+ return typeof raw === 'string' && RISKS.has(raw) ? raw : 'exec';
12
+ }
13
+ function riskFor(definition, config) {
14
+ if (config.risks !== undefined && typeof config.risks === 'object') {
15
+ const own = config.risks[definition.name];
16
+ if (own !== undefined)
17
+ return normalizeRisk(own);
18
+ }
19
+ return normalizeRisk(config.risk);
20
+ }
21
+ /** 把 dsh render 的内容块折成 dsc 的工具输出:文本拼起来,图像块以占位说明。 */
22
+ function blocksToOutput(blocks, name) {
23
+ if (!Array.isArray(blocks)) {
24
+ return typeof blocks === 'string' ? blocks : JSON.stringify(blocks, null, 2);
25
+ }
26
+ const texts = [];
27
+ const images = [];
28
+ for (const block of blocks) {
29
+ if (block?.type === 'text' && typeof block.text === 'string')
30
+ texts.push(block.text);
31
+ else if (block?.type === 'image')
32
+ texts.push(`[图像块已省略:${name} 返回的图像 dsc 兼容层暂不投递]`);
33
+ else
34
+ texts.push(JSON.stringify(block, null, 2));
35
+ }
36
+ const text = texts.join('\n');
37
+ return images.length > 0 ? { text, images } : text;
38
+ }
39
+ /** 规范 JSON 值 → 文本(没有 render 时的兜底)。 */
40
+ function valueToText(value) {
41
+ return typeof value === 'string' ? value : JSON.stringify(value, null, 2);
42
+ }
43
+ /**
44
+ * 把一个 dsh ToolDefinition 包成 dsc ToolEntry。转出来的工具:
45
+ * - 参数 schema 原样透传(两边同是 JSON Schema,llm 层怎么发就怎么发);
46
+ * - execute 收到的 exec 只保证有 `signal`(dsc 的执行上下文没有 agent 身份那些字段);
47
+ * - 声明了 timeoutMs 时到点放弃等待(协作式的:工具内部自己看 signal 才是真取消)。
48
+ */
49
+ export function dshToolToEntry(definition, config) {
50
+ const name = typeof definition.name === 'string' ? definition.name : 'unknown';
51
+ const execute = definition.execute;
52
+ const render = definition.output !== null && typeof definition.output === 'object'
53
+ ? definition.output.render
54
+ : undefined;
55
+ const renderFn = typeof render === 'function' ? render : undefined;
56
+ const timeoutMs = typeof definition.timeoutMs === 'number' && definition.timeoutMs > 0 ? definition.timeoutMs : undefined;
57
+ const run = async (args, ctx) => {
58
+ if (execute === undefined)
59
+ throw new Error(`工具 ${name} 没有 execute 实现`);
60
+ const exec = { signal: ctx.signal, cwd: ctx.cwd };
61
+ const value = timeoutMs === undefined ? await execute(args, exec) : await withTimeout(execute(args, exec), name, timeoutMs);
62
+ return renderFn !== undefined ? blocksToOutput(renderFn(args, value), name) : valueToText(value);
63
+ };
64
+ return {
65
+ name,
66
+ description: typeof definition.description === 'string' ? definition.description : '',
67
+ parameters: definition.parameters !== null && typeof definition.parameters === 'object'
68
+ ? definition.parameters
69
+ : { type: 'object', properties: {} },
70
+ risk: riskFor(definition, config),
71
+ run,
72
+ };
73
+ }
74
+ async function withTimeout(promise, name, timeoutMs) {
75
+ let timer;
76
+ const timeout = new Promise((_, reject) => {
77
+ timer = setTimeout(() => reject(new Error(`工具 ${name} 超时(${timeoutMs}ms)`)), timeoutMs);
78
+ });
79
+ try {
80
+ return await Promise.race([promise, timeout]);
81
+ }
82
+ finally {
83
+ if (timer !== undefined)
84
+ clearTimeout(timer);
85
+ }
86
+ }
87
+ /**
88
+ * dsh `ctx.tools` 的兼容面:register 收 dsh ToolDefinition,其余成员一律响亮报错——
89
+ * 静默装作支持只会让插件在更深处莫名坏掉。risk 映射每次注册时经 readConfig 现读,
90
+ * 插件条目配置里改 risk 不必重挂。
91
+ */
92
+ export function dshToolsFacade(register, readConfig) {
93
+ const target = {
94
+ register(definition) {
95
+ if (!looksLikeDshToolDefinition(definition)) {
96
+ throw new Error('ctx.tools.register 收到的不是 dsh 风格的工具定义(要有 name/execute)');
97
+ }
98
+ return register(dshToolToEntry(definition, readConfig()));
99
+ },
100
+ };
101
+ return new Proxy(target, {
102
+ get(item, prop, receiver) {
103
+ if (prop in item)
104
+ return Reflect.get(item, prop, receiver);
105
+ throw new Error(`dsc 兼容层只支持 ctx.tools.register,当前插件调用了 ctx.tools.${String(prop)}`);
106
+ },
107
+ });
108
+ }
@@ -0,0 +1,13 @@
1
+ /**
2
+ * error → 文案(全仓库唯一一份)。
3
+ *
4
+ * 为什么在 core 单独放这么小的一个模块:这句话此前抄了五份(adapter/transcript、
5
+ * core/loop、core/market、core/plugin-loader、渲染层 SettingsModal 各一份)。内核层
6
+ * 不能反向 import adapter,渲染层只能 import 纯 core 模块——放 core 两头都够得着
7
+ * (渲染层照 diff-text 的先例经 `@dsc/runtime/err-text.js` 取用;adapter/transcript
8
+ * 保留同名 re-export,既有 18 处 import 不断)。
9
+ *
10
+ * @module dsc/core/err-text
11
+ */
12
+ /** 把抛出来的东西压成一句话(Error 取 message,其余 String 化)。 */
13
+ export declare function errText(error: unknown): string;
@@ -0,0 +1,15 @@
1
+ /**
2
+ * error → 文案(全仓库唯一一份)。
3
+ *
4
+ * 为什么在 core 单独放这么小的一个模块:这句话此前抄了五份(adapter/transcript、
5
+ * core/loop、core/market、core/plugin-loader、渲染层 SettingsModal 各一份)。内核层
6
+ * 不能反向 import adapter,渲染层只能 import 纯 core 模块——放 core 两头都够得着
7
+ * (渲染层照 diff-text 的先例经 `@dsc/runtime/err-text.js` 取用;adapter/transcript
8
+ * 保留同名 re-export,既有 18 处 import 不断)。
9
+ *
10
+ * @module dsc/core/err-text
11
+ */
12
+ /** 把抛出来的东西压成一句话(Error 取 message,其余 String 化)。 */
13
+ export function errText(error) {
14
+ return error instanceof Error ? error.message : String(error);
15
+ }
@@ -0,0 +1,149 @@
1
+ /**
2
+ * core 事件流:MiniAgent 对外发布的唯一通道,adapter 消费它折叠成
3
+ * contract 快照(对应 dsh 的 session/event + agent/assistant-stream 合体,
4
+ * 但形状自定、零宿主依赖)。
5
+ *
6
+ * @module dsc/core/events
7
+ */
8
+ import type { FileChangeSummary } from './tools.js';
9
+ import type { RequestSegments } from './token-estimate.js';
10
+ import type { SubagentCardView } from '../contract.js';
11
+ /** MiniAgent 事件。 */
12
+ export type CoreEvent =
13
+ /**
14
+ * 用户输入已入会话(回显);images 是随消息发出去的 data URL 清单。
15
+ *
16
+ * `steering` = 这条是在助手回合**还没跑完**时插进来的(对照 dsh 的 steering 节点)。
17
+ * 它同样会被并进这一轮的下一次模型请求(messages 是同一份),区别只在界面上:
18
+ * 轮中途插过话的那一轮不再提供整轮折叠(对照 dsh 的 `hasInterleavedInput`)。
19
+ */
20
+ {
21
+ type: 'user';
22
+ text: string;
23
+ images?: string[];
24
+ steering?: boolean;
25
+ }
26
+ /**
27
+ * 收件箱变了(入箱 / 编辑 / 删除 / 提前),本身不产生条目:界面照快照里的
28
+ * `queued` 画输入框下方的队列条。发这条是为了让快照失效重画——排队的消息
29
+ * 不再是「入箱即画的气泡」(0.6.67 起改由 drainInbox 出账时才发 `user`)。
30
+ */
31
+ | {
32
+ type: 'inbox';
33
+ }
34
+ /**
35
+ * 一次模型请求的定稿(直播尾此刻应折叠为定稿条目)。
36
+ *
37
+ * `finishReason` 是协议给的收尾原因;`'length'` 表示这次输出撞上了长度上限
38
+ * (对照 dsh 的 `turn-max-tokens` 节点)。拿不到时传 null。
39
+ */
40
+ | {
41
+ type: 'message';
42
+ text: string;
43
+ reasoning: string;
44
+ finishReason?: string | null;
45
+ }
46
+ /** 流式增量(直播尾)。 */
47
+ | {
48
+ type: 'delta';
49
+ kind: 'text' | 'reasoning';
50
+ text: string;
51
+ } | {
52
+ type: 'tool/call';
53
+ callId: string;
54
+ name: string;
55
+ args: string;
56
+ }
57
+ /**
58
+ * 模型开始吐某个工具调用的名字,参数还没到齐(对照 dsh 的 `preparing` 节点)。
59
+ * 它计一次调用、不解析参数,界面上只渲染成不可展开的一行。
60
+ */
61
+ | {
62
+ type: 'tool/prepare';
63
+ name: string;
64
+ }
65
+ /**
66
+ * 这条工具调用的结果;`ms` 是「发起 → 结果」的墙钟耗时(毫秒)。
67
+ *
68
+ * 只有真的发过 `tool/call` 的调用才有这个数:被打断时给没开始的调用补的合成结果
69
+ * (协议要求成对)没有起点,就不报——用量日志里同一口径(宁缺不假)。
70
+ */
71
+ | {
72
+ type: 'tool/result';
73
+ callId: string;
74
+ text: string;
75
+ error?: string;
76
+ ms?: number;
77
+ }
78
+ /**
79
+ * 一次成功的 write / edit 落盘后的实际改动(紧跟在同 callId 的 `tool/result` 之后)。
80
+ * adapter 折成 `kind: 'changes'` 条目,界面聚合成轮尾「文件已更改」卡。
81
+ */
82
+ | {
83
+ type: 'tool/changes';
84
+ callId: string;
85
+ change: FileChangeSummary;
86
+ }
87
+ /**
88
+ * 回合收尾的聚合改动(codex TurnDiffUpdatedNotification 的同位事件):本回合动过的
89
+ * 每个文件出一份「回合基线 vs 盘上终态」的差异,同文件多刀合并成一条。紧跟在
90
+ * `turn/end` 之后发;adapter 折成 `kind: 'turnDiff'` 条目,界面优先拿它画轮尾卡。
91
+ * 不落盘——重启恢复后界面回退逐刀合并显示。
92
+ */
93
+ | {
94
+ type: 'turn/diff';
95
+ files: FileChangeSummary[];
96
+ }
97
+ /** 这次模型请求失败、正要重试(对照 dsh 的 `model-retry` 节点)。 */
98
+ | {
99
+ type: 'model/retry';
100
+ attempt: number;
101
+ reason: string;
102
+ }
103
+ /**
104
+ * 一次请求的用量。cacheHit/cacheMiss 是输入里的前缀缓存明细(端点上报时才有):
105
+ * 命中率是「请求前缀有没有被改写」的直接读数——改一个字节就会让整段历史全价重读,
106
+ * 用量统计页把它展示出来(2026-10-03 起)。
107
+ *
108
+ * `model` 是这次请求实际用的模型 id(0.6.60 起):费用估算按笔归属到模型价目,
109
+ * 会话中途换模型不会把 A 模型的用量算到 B 的单价上。
110
+ *
111
+ * 0.6.67 起随带这一步的三个墙钟读数(毫秒,口径见 core/loop.ts 的 stepTiming):
112
+ * `llmMs` 发出→定稿、`ttftMs` 发出→第一口输出、`decodeMs` 第一口输出→定稿。
113
+ * 拿不到第一口时后两项不报(没有分母就不报数,不编 0)。
114
+ */
115
+ | {
116
+ type: 'usage';
117
+ inputTokens: number;
118
+ outputTokens: number;
119
+ cacheHitTokens?: number;
120
+ cacheMissTokens?: number;
121
+ model?: string;
122
+ llmMs?: number;
123
+ ttftMs?: number;
124
+ decodeMs?: number;
125
+ }
126
+ /**
127
+ * 一次请求组装完成、马上要发出去:附带这份请求按内容类型的 token 估算分段。
128
+ * 发在流式**之前**,context 条在模型还没吐字时就能画出当前的上下文组成。
129
+ */
130
+ | {
131
+ type: 'context';
132
+ segments: RequestSegments;
133
+ }
134
+ /**
135
+ * 子代理活动快照(subagent 插件转发,仅当队友的父会话正被查看):adapter 按
136
+ * 队友名原位更新内联卡。每次都是全量行,没有增量语义。
137
+ */
138
+ | {
139
+ type: 'subagent';
140
+ row: SubagentCardView;
141
+ } | {
142
+ type: 'error';
143
+ message: string;
144
+ } | {
145
+ type: 'turn/start';
146
+ } | {
147
+ type: 'turn/end';
148
+ reason: 'completed' | 'aborted' | 'error';
149
+ };
@@ -0,0 +1 @@
1
+ export {};