@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,167 @@
1
+ /**
2
+ * 内置命令表(spec 单一真源;handler 在插件 apply 时注册)。
3
+ *
4
+ * `shell: true` 那批是**桌面壳输入框里列得出来、也执行得了**的命令(界面通道的
5
+ * `listUiCommands` / `runUiCommand` 只认它们,见 core/ui-methods.ts)。挑的尺子两条,
6
+ * 缺一不可:
7
+ *
8
+ * 1. 动作不出界面通道已有的权力面:`/new` ≈ `openSession`、`/compact` ≈ `compact`、
9
+ * `/review` ≈ `submit`、`/diff` ≈ `dock` 读类,其余四条只往会话里写一条系统通知;
10
+ * 2. 壳里没有更顺手的替身:权限三根旋钮(`/policy` `/reviewer` `/permission`)与
11
+ * `/model` `/effort` 的旋钮就长在输入框底栏,`/resume` `/settings` `/agents`
12
+ * `/plugins` 各有常驻入口——在壳里再列一遍只会多出第二条真源。
13
+ *
14
+ * 硬理由不放的那几条:`/export`(往任意路径写文件)、`/ui-trust`(落第三方界面插件的
15
+ * 信任记录)、`/exit`(宿主生命周期)写完面一律留在原生桥(core/native-bridge.ts),
16
+ * 那是只对装了 preload 的桌面窗口开放的一条路;`/copy` 动的是**宿主**机器的剪贴板,
17
+ * 手机端看着像复制到自己手机上,语义错位。
18
+ */
19
+ export const BUILT_IN_COMMANDS = [
20
+ // T44:duringTask = 回合跑着的时候还能不能用。new/resume 会打断挂着审批的回合、
21
+ // compact 会和进行中的落库交错,运行中一律挡下;其余随时可用。
22
+ { name: 'new', args: '', description: '新建会话', duringTask: 'deny', shell: true },
23
+ { name: 'resume', args: '', description: '恢复历史会话(先选工作区再选会话)', duringTask: 'deny' },
24
+ { name: 'agents', args: '', description: '查看子代理与后台会话(转录只读)' },
25
+ { name: 'compact', args: '', description: '压缩上下文', duringTask: 'deny', shell: true },
26
+ {
27
+ name: 'model',
28
+ args: '<[端点/]模型名>',
29
+ description: '切换模型,下一次请求生效(无参数打开选择器)',
30
+ },
31
+ { name: 'policy', args: '[readonly|auto-edit|full-access]', description: '查看或切换权限模式(自动放行集那一轴)' },
32
+ { name: 'reviewer', args: '[user|auto-review]', description: '查看或切换审批审阅者(要问的事先给谁看)' },
33
+ { name: 'permission', args: '[预设名]', description: '查看或切换打包权限预设(沙箱 + 权限模式 + 审阅者三合一)' },
34
+ { name: 'effort', args: '[default|off|low|high|max]', description: '查看或切换思考强度' },
35
+ { name: 'thinking', args: '[on|off]', description: '切换思考块展开显示(无参数 = 翻转,会话内生效)' },
36
+ { name: 'fork', args: '', description: '分叉当前会话为可恢复的副本(当前会话不变)', duringTask: 'deny' },
37
+ { name: 'plugins', args: '', description: '查看已挂载插件清单(启停与详情在桌面端插件中心)' },
38
+ { name: 'ui-trust', args: '<插件目录名>', description: '信任一个第三方界面插件(首次安装的确认动作)' },
39
+ { name: 'update', args: '', description: '检查有没有新版(只查不装)', duringTask: 'deny' },
40
+ { name: 'status', args: '', description: '查看上下文占用与压缩余量', shell: true },
41
+ { name: 'usage', args: '', description: '查看累计用量统计(含缓存命中率)', shell: true },
42
+ { name: 'diff', args: '[文件]', description: '查看工作区未提交改动的 diff', shell: true },
43
+ { name: 'copy', args: '', description: '复制上一条回复到剪贴板' },
44
+ { name: 'export', args: '[文件路径]', description: '导出当前会话为 markdown' },
45
+ { name: 'review', args: '[关注点]', description: '审查工作区未提交改动', shell: true },
46
+ { name: 'settings', args: '', description: '打开设置页' },
47
+ { name: 'help', args: '', description: '查看帮助', shell: true },
48
+ { name: 'exit', args: '', description: '退出' },
49
+ ];
50
+ /** 外部插件注册的命令(补全与唯一前缀展开用;模块级单例,进程内唯一注册表)。 */
51
+ const extraSpecs = [];
52
+ /** 全量 spec:内置 + 外部插件注册的。 */
53
+ export const allSpecs = () => [...BUILT_IN_COMMANDS, ...extraSpecs];
54
+ /** 外部插件注册成功后把 spec 挂进来(registry 是唯一调用方)。 */
55
+ export function addExtraSpec(spec) {
56
+ extraSpecs.push(spec);
57
+ }
58
+ /** 外部插件注销时摘掉。 */
59
+ export function removeExtraSpec(spec) {
60
+ const at = extraSpecs.findIndex((entry) => entry.name === spec.name);
61
+ if (at >= 0)
62
+ extraSpecs.splice(at, 1);
63
+ }
64
+ /**
65
+ * 壳(桌面 / 手机那份插件化界面)可见也可执行的命令:`shell: true` 那批。
66
+ *
67
+ * 界面通道的 `listUiCommands`(菜单数据源)与 `runUiCommand`(派发闸)都读这一份,
68
+ * 所以「菜单里列出来的」与「真能执行的」不可能各说各话。外部插件默认不在里面
69
+ * (spec 不标 `shell` 就不进)——失败关闭;宿主侧插件本就有完整宿主权力,标了也只是
70
+ * 把它自己的命令摆到菜单里,不多给任何东西。
71
+ */
72
+ export const shellCommands = () => allSpecs().filter((spec) => spec.shell === true);
73
+ /** 这个名字能不能从壳里执行(`runUiCommand` 的闸;大小写与展开后的名字比)。 */
74
+ export function isShellCommand(name) {
75
+ return allSpecs().some((spec) => spec.name === name && spec.shell === true);
76
+ }
77
+ /**
78
+ * 界面通道派发前的那道闸(`runUiCommand` 只做两件事:问它、照原样派发)。
79
+ *
80
+ * 独立成纯函数是为了能直测:它是「壳能跑什么」这句话的可执行版本,而 `runCommand`
81
+ * 那条路(终端与旧桌面渲染层用)**不过这道闸**——两边的差别只在这里。
82
+ *
83
+ * @returns null = 放行;字符串 = 给用户看的原因(调用方原样抛出去)。
84
+ */
85
+ export function shellCommandRejection(input) {
86
+ if (!input.startsWith('/'))
87
+ return '界面通道的命令派发只接 `/` 开头的输入';
88
+ // 名字按「唯一前缀展开」算(`/rev` → `/review`),与 TUI 敲一半按回车的口径一致。
89
+ const expanded = expandCommand(input);
90
+ const name = expanded.slice(1).trim().split(/\s+/)[0] ?? '';
91
+ // 裸 `/`(没有名字)落到 /help,与 TUI 同一条出口,不算越界。
92
+ if (name === '')
93
+ return null;
94
+ if (isShellCommand(name))
95
+ return null;
96
+ return `/${name} 不在桌面壳的命令清单里(输入框打 / 看能用的那几条;权限、模型、退出这些在界面上有旋钮或按钮)`;
97
+ }
98
+ /** /help 文本(命令表驱动)。 */
99
+ export function helpText(specs) {
100
+ return specs
101
+ .map((command) => `/${command.name}${command.args === '' ? '' : ` ${command.args}`}\t${command.description}`)
102
+ .join('\n');
103
+ }
104
+ /** 兼容导出:v2 的 HELP_TEXT(内置表静态快照)。 */
105
+ export const HELP_TEXT = helpText(BUILT_IN_COMMANDS);
106
+ /**
107
+ * 命令候选(输入 `/` 或 `/mo` 阶段)。
108
+ * 已进入参数阶段(含空格)或非命令输入返回空。
109
+ */
110
+ export function commandCompletions(input) {
111
+ if (!input.startsWith('/'))
112
+ return [];
113
+ const body = input.slice(1);
114
+ if (body.includes(' '))
115
+ return [];
116
+ const lower = body.toLowerCase();
117
+ return allSpecs()
118
+ .filter((command) => command.name.startsWith(lower))
119
+ .map((command) => ({
120
+ insert: `/${command.name}${command.args === '' ? '' : ' '}`,
121
+ label: `/${command.name}${command.args === '' ? '' : ` ${command.args}`}`,
122
+ description: command.description,
123
+ }));
124
+ }
125
+ /**
126
+ * 模型候选(`/model ` 参数阶段):展示全部可切换模型的 `端点/模型名`。
127
+ * 补全到精确匹配后面板自动关闭;`model 名`本身也可前缀匹配(`/model deep`)。
128
+ */
129
+ export function modelCompletions(input, models) {
130
+ if (!input.startsWith('/model'))
131
+ return [];
132
+ const body = input.slice('/model'.length);
133
+ if (!body.startsWith(' '))
134
+ return []; // 还没打空格:交给命令候选
135
+ const arg = body.slice(1);
136
+ if (arg.includes(' '))
137
+ return []; // 参数已完整(带后续参数不适用于 /model)
138
+ const lower = arg.toLowerCase();
139
+ const matched = models.filter((choice) => choice.value.toLowerCase().startsWith(lower) || choice.model.toLowerCase().startsWith(lower));
140
+ if (matched.length === 1 && matched[0].value.toLowerCase() === lower)
141
+ return [];
142
+ return matched.map((choice) => ({
143
+ insert: `/model ${choice.value}`,
144
+ label: choice.value,
145
+ description: choice.description,
146
+ }));
147
+ }
148
+ /** 统一补全入口:model 参数阶段优先,否则按命令前缀。 */
149
+ export function completionsFor(input, models) {
150
+ const byModel = modelCompletions(input, models);
151
+ return byModel.length > 0 ? byModel : commandCompletions(input);
152
+ }
153
+ /**
154
+ * 命令名唯一前缀自动展开(`/ne` → `/new`);多候选或已精确匹配时原样返回。
155
+ * 供 Enter 提交前调用,避免"输了一半按回车报未知命令"。
156
+ */
157
+ export function expandCommand(input) {
158
+ if (!input.startsWith('/'))
159
+ return input;
160
+ const body = input.slice(1);
161
+ if (body.includes(' '))
162
+ return input;
163
+ if (allSpecs().some((command) => command.name === body))
164
+ return input;
165
+ const matches = allSpecs().filter((command) => command.name.startsWith(body.toLowerCase()));
166
+ return matches.length === 1 ? `/${matches[0].name}` : input;
167
+ }
@@ -0,0 +1,76 @@
1
+ /**
2
+ * 压缩摘要的机械加固件:锚点索引(正则从原文抽,不经模型改写)、
3
+ * 真实用户原话逐字引用、压前读过的文件状态(read-state)、细节找回指针。
4
+ *
5
+ * 为什么单独成模块:这几样是「摘要里不许走样」的最后一道保险,全是纯函数,
6
+ * 可以脱离模型单独断言(见 scripts/compact-readstate-test.mjs)。
7
+ *
8
+ * @module dsc/core/compact-anchors
9
+ */
10
+ import type { ChatMessage } from './llm.js';
11
+ /** 摘要消息的开头标记。摘要本身也是一条 `role: 'user'` 的消息,靠它把真用户消息认出来。 */
12
+ export declare const SUMMARY_BANNER = "[\u5148\u524D\u5BF9\u8BDD\u7684\u4EA4\u63A5\u6458\u8981\uFF08\u539F\u6587\u5DF2\u538B\u7F29\uFF09]";
13
+ /** 锚点索引的字符预算缺省值(可配 `compact.anchorBudgetChars`)。 */
14
+ export declare const DEFAULT_ANCHOR_BUDGET_CHARS = 6000;
15
+ /** 用户原话引用的字符预算缺省值(可配 `compact.userQuoteBudgetChars`)。 */
16
+ export declare const DEFAULT_USER_QUOTE_BUDGET_CHARS = 8000;
17
+ /** read-state 段最多列几个文件(可配 `compact.readStateFiles`)。 */
18
+ export declare const DEFAULT_READ_STATE_FILES = 5;
19
+ /** read-state 段的字符预算缺省值(可配 `compact.readStateChars`)。 */
20
+ export declare const DEFAULT_READ_STATE_BUDGET_CHARS = 1500;
21
+ /**
22
+ * 从被压缩的原文里抽锚点索引:PR 号、commit、分支、文件、报错、链接。
23
+ * @param text - 压缩区原文。**不要**传截断过的转写——工具参数被截到 120 字符时,路径与报错会断在半截上。
24
+ * @param budgetChars - 整段索引(含标题与脚注)的字符预算;装不下的整类丢掉,不切半行。
25
+ * @returns 形如 `\n\n## 锚点索引……\nPR 号与 issue:#12\n……` 的文本;一条都没抽到或预算装不下标题时返回空串。
26
+ */
27
+ export declare function buildAnchorIndex(text: string, budgetChars: number): string;
28
+ /**
29
+ * 这条消息是不是「真用户说的话」。
30
+ * 压缩后的摘要本身在内存里就是一条 `role: 'user'` 的消息,不能把它当用户原话再引一遍。
31
+ * @param message - 待判消息。
32
+ * @returns 是真实用户消息(有正文、且不是摘要)返回 true。
33
+ */
34
+ export declare function isRealUserMessage(message: ChatMessage): boolean;
35
+ /**
36
+ * 截断一段文本,截断处补省略标记。
37
+ * @param text - 原文。
38
+ * @param maxChars - 结果的最大字符数。
39
+ * @returns 长度不超过 `maxChars` 的文本;空间连省略标记都放不下时只按长度切,不补标记。
40
+ */
41
+ export declare function elide(text: string, maxChars: number): string;
42
+ /**
43
+ * 逐字引用压缩区里的真实用户消息(最新在前)。
44
+ * @param messages - 压缩区的消息;其中形如摘要的「假 user」会被排除。
45
+ * @param budgetChars - 整段引用(含标题与脚注)的字符预算;超了就丢最老的几条,单条超长用省略号切断。
46
+ * @returns 引用区文本;一条真用户消息都没有、或预算装不下标题时返回空串。
47
+ */
48
+ export declare function collectVerbatimUserMessages(messages: readonly ChatMessage[], budgetChars: number): string;
49
+ /**
50
+ * 从被压缩的区间里机械抽出「压前最后读过哪些文件、读到哪」。
51
+ *
52
+ * 为什么要有它:锚点索引抽的是「原文出现过哪些路径」,接手的模型看不出「这些文件我刚读到哪」,
53
+ * 只能重读一遍。这里按最后一次 read 的位置去重(同一文件读多次只留最后一次),
54
+ * 只带路径与行范围——**不带文件内容**,省 token 且不会把已被改的旧内容当真相。
55
+ *
56
+ * @param messages - 被折区间的消息(真实消息,不是转写)。
57
+ * @param budgetChars - 整段(含标题与脚注)的字符预算;装不下的文件丢掉并补省略标记。
58
+ * @param maxFiles - 最多列几个文件(按最后一次读的先后,最近的在前);缺省 5。
59
+ * @returns 形如 `\n\n## 读过的文件……\n- D:\a\b.ts:第 1–100 行\n……` 的文本;
60
+ * 一个文件都没读过、`maxFiles <= 0` 或预算装不下标题时返回空串(**不产生空段**)。
61
+ */
62
+ export declare function buildReadState(messages: readonly ChatMessage[], budgetChars: number, maxFiles?: number): string;
63
+ /** 细节找回指针要填的内容。 */
64
+ export interface RecoveryPointer {
65
+ /** 这次折进摘要的消息条数。 */
66
+ regionMessages: number;
67
+ /** 会话 jsonl 的路径:手上没有检索工具时读它。 */
68
+ sessionFile: string;
69
+ }
70
+ /**
71
+ * 生成「细节找回」指针:被折掉的原文还在会话日志里,需要细节时去哪儿看。
72
+ * 写成条件句:当前有 `session_search` 工具就用它,没有就直接读 jsonl——不许硬依赖某个工具存在。
73
+ * @param pointer - 折掉多少条、日志在哪个文件。
74
+ * @returns 附在摘要末尾的指针文本。
75
+ */
76
+ export declare function buildRecoveryFooter(pointer: RecoveryPointer): string;
@@ -0,0 +1,284 @@
1
+ import { contentText } from './llm.js';
2
+ /** 摘要消息的开头标记。摘要本身也是一条 `role: 'user'` 的消息,靠它把真用户消息认出来。 */
3
+ export const SUMMARY_BANNER = '[先前对话的交接摘要(原文已压缩)]';
4
+ /** 锚点索引的标题。 */
5
+ const ANCHOR_HEADING = '## 锚点索引(正则从原文机械抽取)';
6
+ /** 锚点索引的脚注。 */
7
+ const ANCHOR_NOTE = '(以上标识符逐字来自被压缩的原文,引用时照抄,不要改写。)';
8
+ /** 用户原话区的标题。 */
9
+ const USER_HEADING = '## 用户原话(逐字引用,最新在前)';
10
+ /** 用户原话区的脚注。 */
11
+ const USER_NOTE = '(上面是压缩区里真实用户说过的话,逐字引用;摘要的转述与它们冲突时以这些话为准。)';
12
+ /** 细节找回区的标题。 */
13
+ const RECOVERY_HEADING = '## 细节找回';
14
+ /** 截断标记。 */
15
+ const ELISION_MARKER = '……(后文省略)';
16
+ /** 单条用户原话最多引这么多字符,免得一次长粘贴吃掉整个预算。 */
17
+ const USER_MESSAGE_MAX_CHARS = 4000;
18
+ /** read-state 段的标题。文案本身带上「可能已过时」,因为它是提示不是真相。 */
19
+ const READ_STATE_HEADING = '## 读过的文件(可能已过时,需要时重读)';
20
+ /** read-state 段的脚注。 */
21
+ const READ_STATE_NOTE = '(压缩前最后读过这些文件与行范围,供接手时不重读;它们可能已被改,要确切内容就重读。)';
22
+ /** 锚点索引的字符预算缺省值(可配 `compact.anchorBudgetChars`)。 */
23
+ export const DEFAULT_ANCHOR_BUDGET_CHARS = 6000;
24
+ /** 用户原话引用的字符预算缺省值(可配 `compact.userQuoteBudgetChars`)。 */
25
+ export const DEFAULT_USER_QUOTE_BUDGET_CHARS = 8000;
26
+ /** read-state 段最多列几个文件(可配 `compact.readStateFiles`)。 */
27
+ export const DEFAULT_READ_STATE_FILES = 5;
28
+ /** read-state 段的字符预算缺省值(可配 `compact.readStateChars`)。 */
29
+ export const DEFAULT_READ_STATE_BUDGET_CHARS = 1500;
30
+ /** 认得出的源码/配置扩展名:文件锚点按它认文件,分支过滤按它排除网址里的路径。 */
31
+ const SOURCE_EXTENSIONS = [
32
+ 'ts', 'tsx', 'js', 'mjs', 'cjs', 'jsx', 'py', 'rs', 'go',
33
+ 'md', 'yaml', 'yml', 'json', 'toml', 'sh', 'ps1', 'css', 'html',
34
+ ];
35
+ const SOURCE_EXTENSION = new RegExp(`\\.(?:${SOURCE_EXTENSIONS.join('|')})$`, 'i');
36
+ /** 文件锚点:路径里允许反斜杠,dsc 在 Windows 上跑,日志里的路径多半是 `D:\a\b.ts`。 */
37
+ const FILE_PATTERN = new RegExp(`\\b[\\w.\\\\/-]*[\\\\/][\\w.-]+\\.(?:${SOURCE_EXTENSIONS.join('|')})\\b`, 'g');
38
+ /** uuid 里十六进制字符的判据。 */
39
+ const HEX = /[0-9a-fA-F]/;
40
+ /**
41
+ * uuid 末段是 12 位十六进制,正中 commit 的 `\b[0-9a-f]{9,40}\b`。
42
+ * 前一位是 `-`、再前一位还是十六进制字符,就说明这串是 uuid 尾巴而不是 commit。
43
+ */
44
+ function notUuidTail(text, match) {
45
+ return !(match.index >= 2 && text[match.index - 1] === '-' && HEX.test(text[match.index - 2]));
46
+ }
47
+ /**
48
+ * 网址里的路径会被分支名正则带出来(`example.com/docs/compact.ts` 命中 `docs/compact.ts`)。
49
+ * 前一位是路径分隔符、点或连字符时,它是一段更长路径的一部分,不是分支名;
50
+ * 以已知源码扩展名结尾的同样不是分支名。
51
+ */
52
+ function notPathFragment(text, match) {
53
+ if (match.index > 0 && /[\w./\\-]/.test(text[match.index - 1]))
54
+ return false;
55
+ return !SOURCE_EXTENSION.test(match.value);
56
+ }
57
+ /** 锚点分类:照 hermes 的分类,去掉 dsc 里不存在的 `@handle`。 */
58
+ const ANCHOR_CATEGORIES = [
59
+ { label: 'PR 号与 issue', pattern: /#\d{3,6}\b/g, cap: 120 },
60
+ { label: 'commit', pattern: /\b[0-9a-f]{9,40}\b/g, cap: 40, keep: notUuidTail },
61
+ {
62
+ label: '分支',
63
+ pattern: /\b(?:fix|feat|docs|refactor|chore|salvage|ent)\/[A-Za-z0-9._/-]{3,60}/g,
64
+ cap: 40,
65
+ keep: notPathFragment,
66
+ },
67
+ { label: '文件', pattern: FILE_PATTERN, cap: 80 },
68
+ {
69
+ label: '报错',
70
+ // errno 只认 Node / Windows 上真会冒出来的那几个:全大写标识符(EVENT 这类)不该被当报错。
71
+ pattern: /\b(?:[A-Z][a-zA-Z]*(?:Error|Exception)|ENOENT|EACCES|EPERM|ENOSPC|EEXIST|EBUSY|EMFILE|ETIMEDOUT|ECONNREFUSED|ECONNRESET|SIGKILL|SIGTERM|SIGINT|Traceback)\b[^\n]{0,90}/g,
72
+ cap: 40,
73
+ },
74
+ { label: '链接', pattern: /https?:\/\/[^\s)"']{10,110}/g, cap: 30 },
75
+ ];
76
+ /** 抓一类锚点:去重、按出现次数排(次数相同按最后一次出现的先后),带 `(xN)` 计数。 */
77
+ function harvest(text, category) {
78
+ const counts = new Map();
79
+ const lastSeen = new Map();
80
+ for (const found of text.matchAll(category.pattern)) {
81
+ const value = found[0].trim().replace(/[.,;:]+$/, '');
82
+ const match = { value, index: found.index ?? 0 };
83
+ if (value === '' || category.keep?.(text, match) === false)
84
+ continue;
85
+ counts.set(value, (counts.get(value) ?? 0) + 1);
86
+ lastSeen.set(value, match.index);
87
+ }
88
+ return [...counts.keys()]
89
+ .sort((a, b) => (counts.get(b) ?? 0) - (counts.get(a) ?? 0) || (lastSeen.get(b) ?? 0) - (lastSeen.get(a) ?? 0))
90
+ .slice(0, category.cap)
91
+ .map((value) => ((counts.get(value) ?? 0) > 1 ? `${value}(x${counts.get(value) ?? 0})` : value));
92
+ }
93
+ /**
94
+ * 从被压缩的原文里抽锚点索引:PR 号、commit、分支、文件、报错、链接。
95
+ * @param text - 压缩区原文。**不要**传截断过的转写——工具参数被截到 120 字符时,路径与报错会断在半截上。
96
+ * @param budgetChars - 整段索引(含标题与脚注)的字符预算;装不下的整类丢掉,不切半行。
97
+ * @returns 形如 `\n\n## 锚点索引……\nPR 号与 issue:#12\n……` 的文本;一条都没抽到或预算装不下标题时返回空串。
98
+ */
99
+ export function buildAnchorIndex(text, budgetChars) {
100
+ const head = `\n\n${ANCHOR_HEADING}\n`;
101
+ const note = `\n${ANCHOR_NOTE}`;
102
+ let body = '';
103
+ for (const category of ANCHOR_CATEGORIES) {
104
+ const values = harvest(text, category);
105
+ if (values.length === 0)
106
+ continue;
107
+ const next = body === '' ? `${category.label}:${values.join('、')}` : `${body}\n${category.label}:${values.join('、')}`;
108
+ if (head.length + next.length + note.length > budgetChars)
109
+ break;
110
+ body = next;
111
+ }
112
+ return body === '' ? '' : `${head}${body}${note}`;
113
+ }
114
+ /**
115
+ * 这条消息是不是「真用户说的话」。
116
+ * 压缩后的摘要本身在内存里就是一条 `role: 'user'` 的消息,不能把它当用户原话再引一遍。
117
+ * @param message - 待判消息。
118
+ * @returns 是真实用户消息(有正文、且不是摘要)返回 true。
119
+ */
120
+ export function isRealUserMessage(message) {
121
+ if (message.role !== 'user')
122
+ return false;
123
+ const text = contentText(message.content).trim();
124
+ return text !== '' && !text.startsWith(SUMMARY_BANNER);
125
+ }
126
+ /**
127
+ * 截断一段文本,截断处补省略标记。
128
+ * @param text - 原文。
129
+ * @param maxChars - 结果的最大字符数。
130
+ * @returns 长度不超过 `maxChars` 的文本;空间连省略标记都放不下时只按长度切,不补标记。
131
+ */
132
+ export function elide(text, maxChars) {
133
+ if (maxChars <= 0)
134
+ return '';
135
+ if (text.length <= maxChars)
136
+ return text;
137
+ if (maxChars <= ELISION_MARKER.length)
138
+ return clip(text, maxChars);
139
+ return `${clip(text, maxChars - ELISION_MARKER.length)}${ELISION_MARKER}`;
140
+ }
141
+ /** 按长度切字符串,别把代理对(emoji 这类)切成半个。 */
142
+ function clip(text, maxChars) {
143
+ if (maxChars <= 0)
144
+ return '';
145
+ const code = text.charCodeAt(maxChars - 1);
146
+ const cut = code >= 0xd800 && code <= 0xdbff ? maxChars - 1 : maxChars;
147
+ return text.slice(0, cut);
148
+ }
149
+ /** 每行前面加引用号。 */
150
+ function quoteLines(text) {
151
+ return `> ${text.split('\n').join('\n> ')}`;
152
+ }
153
+ /**
154
+ * 逐字引用压缩区里的真实用户消息(最新在前)。
155
+ * @param messages - 压缩区的消息;其中形如摘要的「假 user」会被排除。
156
+ * @param budgetChars - 整段引用(含标题与脚注)的字符预算;超了就丢最老的几条,单条超长用省略号切断。
157
+ * @returns 引用区文本;一条真用户消息都没有、或预算装不下标题时返回空串。
158
+ */
159
+ export function collectVerbatimUserMessages(messages, budgetChars) {
160
+ const head = `\n\n${USER_HEADING}\n`;
161
+ const note = `\n${USER_NOTE}`;
162
+ const room0 = budgetChars - head.length - note.length;
163
+ if (room0 <= 0)
164
+ return '';
165
+ const quotes = [];
166
+ let used = 0;
167
+ for (let index = messages.length - 1; index >= 0; index -= 1) {
168
+ const message = messages[index];
169
+ if (!isRealUserMessage(message))
170
+ continue;
171
+ const text = contentText(message.content).trim();
172
+ const gap = quotes.length === 0 ? 0 : 2;
173
+ const room = room0 - used - gap;
174
+ // 引用号占 `2 × 行数`,先把这块留出来,剩下的才是正文能用的字符数
175
+ const limit = Math.min(USER_MESSAGE_MAX_CHARS, room - 2 * text.split('\n').length);
176
+ if (limit <= 0)
177
+ break;
178
+ const quoted = quoteLines(elide(text, limit));
179
+ quotes.push(quoted);
180
+ used += quoted.length + gap;
181
+ }
182
+ return quotes.length === 0 ? '' : `${head}${quotes.join('\n\n')}${note}`;
183
+ }
184
+ /**
185
+ * 从一条 tool 调用的参数里认出「read 了哪个文件、读了哪一段」。
186
+ * 本工具的字段名是 `path`(不是 Codex 的 `file_path`);参数是模型给的 JSON 串,
187
+ * 可能不是合法 JSON(被截断),认不出就整条跳过——read-state 只放确定认下的。
188
+ * @param args - assistant 消息里那次 tool 调用的 `function.arguments` 原文。
189
+ * @returns 认出返回 { path, range };不是文件读取或参数认不出返回 null。
190
+ */
191
+ function readStateOf(args) {
192
+ let parsed;
193
+ try {
194
+ parsed = JSON.parse(args);
195
+ }
196
+ catch {
197
+ return null;
198
+ }
199
+ if (parsed === null || typeof parsed !== 'object')
200
+ return null;
201
+ const record = parsed;
202
+ if (typeof record.path !== 'string' || record.path.trim() === '')
203
+ return null;
204
+ // offset 是 1-based;缺省(或给了非法值)当从第 1 行读起。
205
+ const rawOffset = typeof record.offset === 'number' && Number.isFinite(record.offset) ? Math.floor(record.offset) : 1;
206
+ const start = rawOffset > 1 ? rawOffset : 1;
207
+ // limit 缺省时不知道读了多少行(缺省行数由 tools 插件配,这一层拿不到),只写「起」。
208
+ const limit = typeof record.limit === 'number' && Number.isFinite(record.limit) ? Math.floor(record.limit) : undefined;
209
+ const range = limit !== undefined && limit > 0 ? `第 ${start}–${start + limit - 1} 行` : `第 ${start} 行起`;
210
+ return { path: record.path.trim(), range };
211
+ }
212
+ /**
213
+ * 从被压缩的区间里机械抽出「压前最后读过哪些文件、读到哪」。
214
+ *
215
+ * 为什么要有它:锚点索引抽的是「原文出现过哪些路径」,接手的模型看不出「这些文件我刚读到哪」,
216
+ * 只能重读一遍。这里按最后一次 read 的位置去重(同一文件读多次只留最后一次),
217
+ * 只带路径与行范围——**不带文件内容**,省 token 且不会把已被改的旧内容当真相。
218
+ *
219
+ * @param messages - 被折区间的消息(真实消息,不是转写)。
220
+ * @param budgetChars - 整段(含标题与脚注)的字符预算;装不下的文件丢掉并补省略标记。
221
+ * @param maxFiles - 最多列几个文件(按最后一次读的先后,最近的在前);缺省 5。
222
+ * @returns 形如 `\n\n## 读过的文件……\n- D:\a\b.ts:第 1–100 行\n……` 的文本;
223
+ * 一个文件都没读过、`maxFiles <= 0` 或预算装不下标题时返回空串(**不产生空段**)。
224
+ */
225
+ export function buildReadState(messages, budgetChars, maxFiles = DEFAULT_READ_STATE_FILES) {
226
+ if (maxFiles <= 0)
227
+ return '';
228
+ const head = `\n\n${READ_STATE_HEADING}\n`;
229
+ const note = `\n${READ_STATE_NOTE}`;
230
+ // 省略标记也占一行,先把它从预算里扣出来,保证真截断时它放得下(结果绝不超过 budgetChars)。
231
+ const room = budgetChars - head.length - note.length - ELISION_MARKER.length - 1;
232
+ if (room <= 0)
233
+ return '';
234
+ // 同文件按最后一次 read 认状态:记录最后一次出现的位置与那时的行范围。
235
+ const lastAt = new Map();
236
+ const lastEntry = new Map();
237
+ messages.forEach((message, index) => {
238
+ for (const call of message.tool_calls ?? []) {
239
+ if (call.function.name !== 'read')
240
+ continue;
241
+ const entry = readStateOf(call.function.arguments);
242
+ if (entry === null)
243
+ continue;
244
+ lastAt.set(entry.path, index);
245
+ lastEntry.set(entry.path, entry);
246
+ }
247
+ });
248
+ if (lastEntry.size === 0)
249
+ return '';
250
+ // 最近读的排前面(最后一次出现的位置越大越近),多余的直接丢。
251
+ const picked = [...lastEntry.keys()]
252
+ .sort((a, b) => (lastAt.get(b) ?? 0) - (lastAt.get(a) ?? 0))
253
+ .slice(0, maxFiles);
254
+ const lines = [];
255
+ let used = 0;
256
+ let truncated = false;
257
+ for (const path of picked) {
258
+ const line = `- ${path}:${lastEntry.get(path)?.range ?? ''}`;
259
+ const gap = lines.length === 0 ? 0 : 1;
260
+ if (used + gap + line.length > room) {
261
+ truncated = true;
262
+ break;
263
+ }
264
+ lines.push(line);
265
+ used += gap + line.length;
266
+ }
267
+ if (lines.length === 0)
268
+ return '';
269
+ const marker = truncated ? `\n${ELISION_MARKER}` : '';
270
+ return `${head}${lines.join('\n')}${marker}${note}`;
271
+ }
272
+ /**
273
+ * 生成「细节找回」指针:被折掉的原文还在会话日志里,需要细节时去哪儿看。
274
+ * 写成条件句:当前有 `session_search` 工具就用它,没有就直接读 jsonl——不许硬依赖某个工具存在。
275
+ * @param pointer - 折掉多少条、日志在哪个文件。
276
+ * @returns 附在摘要末尾的指针文本。
277
+ */
278
+ export function buildRecoveryFooter(pointer) {
279
+ return `\n\n${RECOVERY_HEADING}\n`
280
+ + `这次折掉的 ${pointer.regionMessages} 条消息原文完整留在会话日志里:${pointer.sessionFile}。\n`
281
+ + '摘要没写到的细节(完整命令输出、文件内容、报错原文、更早的思路)需要时:'
282
+ + '当前会话有 session_search 工具就用它按关键词检索,没有这个工具就直接读上面这个 jsonl 文件。\n'
283
+ + '查得到的东西不要猜。';
284
+ }
@@ -0,0 +1,110 @@
1
+ /**
2
+ * 上下文压缩:把旧历史折成一条摘要消息(对应 dsh compaction 的个人版
3
+ * 最小实现——无 span 选择/锁,只有"保头折尾"策略)。
4
+ *
5
+ * 摘要调用复用主对话前缀(2026-10-03,对齐 dsh summarizer 的 warm-prefix 设计):
6
+ * messages = [真实系统提示词, ...被折区间的原始消息, 末尾一条压缩指令],工具目录照发——
7
+ * 辅助调用因此成为上一次真实请求的前缀扩展,命中服务端 KV 缓存;摘要模型看到的也是
8
+ * 对话原貌,而不是截过参数、抹平角色的转写。
9
+ *
10
+ * 摘要之外还附几样机械产物(见 ./compact-anchors.js):正则抽的锚点索引、
11
+ * 真实用户原话逐字引用、压前读过的文件状态(read-state)、细节找回指针。模型写的叙述会漏掉
12
+ * SHA 与报错原文,前几样不走模型;read-state 则是「刚读到哪」的可读提示。
13
+ *
14
+ * 触发:/compact 手动,或 loop 每轮开始前的自动阈值检查
15
+ * (估算 tokens > 80% × 模型 contextWindow)。磁盘上写 summary 记录,
16
+ * 重放时等价折叠。
17
+ *
18
+ * @module dsc/core/compact
19
+ */
20
+ import type { ChatMessage, LlmRoute, LlmStream, ToolSchema } from './llm.js';
21
+ import type { Session } from './session.js';
22
+ import { type SpillConfig } from './spill.js';
23
+ /** 压缩后保留的最近消息条数的缺省值(compact 插件配置没给 `keepRecent` 时用它)。 */
24
+ export declare const DEFAULT_KEEP_RECENT = 20;
25
+ /**
26
+ * 摘要前置裁剪的口径(T19,对标 dsh compaction-tool-result-pruner / compaction-image-offload):
27
+ * 历史送摘要模型之前先机械瘦身——超限工具结果裁掉留 spill 指针、老图片按预算卸载。
28
+ * 只影响摘要输入(省 token、摘要不被日志噪音淹没);锚点索引与原话引用仍取自原文,全量保真。
29
+ */
30
+ export interface PruneOptions {
31
+ /** spill 配置;给值 = 超限工具结果走 `spillText` 落盘留指针(模型可 read 找回)。 */
32
+ spill?: SpillConfig;
33
+ /** 摘要转写里保留原图的张数,之后的图片换成占位说明。 */
34
+ imageBudget: number;
35
+ /** 单条工具结果进摘要转写的字符预算(spill 未配置时纯截断)。 */
36
+ toolResultChars: number;
37
+ }
38
+ /** 前置裁剪的缺省口径。 */
39
+ export declare const DEFAULT_PRUNE_OPTIONS: PruneOptions;
40
+ /** 一次前置裁剪的统计与产物。 */
41
+ export interface PruneOutcome {
42
+ /** 裁剪后的消息(新数组;原数组不动)。 */
43
+ region: ChatMessage[];
44
+ /** 被裁掉并落盘留指针的工具结果条数。 */
45
+ spilledTools: number;
46
+ /** 被占位说明换掉的图片张数。 */
47
+ offloadedImages: number;
48
+ }
49
+ /**
50
+ * 历史的前置裁剪(纯消息变换 + spill 落盘):
51
+ * - 超预算的 string 工具结果 → spill 预览(前几行 + 完整路径 + 续读写法)或纯截断说明;
52
+ * - 带图工具结果的图片全部卸载为占位(截图留在历史里等于每轮重发);
53
+ * - 用户消息图片按预算保留,超出的换「图片已卸载」占位。
54
+ */
55
+ export declare function pruneRegion(messages: readonly ChatMessage[], sessionId: string, options: PruneOptions): PruneOutcome;
56
+ /** 一次压缩的三个上限。前两个是字符预算,由 compact 插件的配置给值。 */
57
+ export interface CompactLimits {
58
+ /** 摘要之外原样保留的最近消息条数。 */
59
+ keepRecent: number;
60
+ /** 锚点索引的字符预算。 */
61
+ anchorChars: number;
62
+ /** 摘要里逐字引用的用户原话的字符预算。 */
63
+ userQuoteChars: number;
64
+ /** 摘要里 read-state(压前读过的文件与行范围)最多列几个文件。 */
65
+ readStateFiles: number;
66
+ /** read-state 段的字符预算。 */
67
+ readStateChars: number;
68
+ }
69
+ /** 各上限的缺省值(compact 插件配置没给时用它)。 */
70
+ export declare const DEFAULT_COMPACT_LIMITS: CompactLimits;
71
+ /**
72
+ * 粗略 token 估算(口径见 core/token-estimate.ts 的模块注释:中文 0.65、其余 0.33)。
73
+ */
74
+ export declare function estimateTokens(messages: readonly ChatMessage[]): number;
75
+ export type CompactOutcome = 'compacted' | 'noop';
76
+ /**
77
+ * 把切点往前退到安全边界:切出来的尾部不能以孤儿 tool 消息开头。
78
+ *
79
+ * 为什么必须退:协议要求每条 `tool` 消息紧跟在带同 id `tool_calls` 的 assistant 消息后面。
80
+ * 从中间切开会让下一轮请求直接 HTTP 400(工具结果找不到对应的调用)。
81
+ * 退到那条 assistant 消息上,工具调用与它的结果就一起留在尾部。
82
+ *
83
+ * @param messages - 当前会话消息。
84
+ * @param cut - 按条数算出来的原始切点。
85
+ * @returns 安全切点;前面全是工具结果时可能退到 0(调用方按无法压缩处理)。
86
+ */
87
+ export declare function safeCut(messages: readonly ChatMessage[], cut: number): number;
88
+ /** 压缩一次;历史太短返回 'noop'(不写任何记录)。 */
89
+ export declare function compactSession(session: Session,
90
+ /** 当前模型路由(api 字段决定走哪个协议适配器)。 */
91
+ route: LlmRoute,
92
+ /** 经适配器表派发的流式请求调用(由 compact 插件从 llm 服务取)。 */
93
+ stream: LlmStream, signal: AbortSignal,
94
+ /** 摘要之外要原样带过去的内容(任务清单、会话目标这类状态,不能被摘要吃掉)。 */
95
+ extra: string | undefined,
96
+ /** 三个上限;compact 插件把它的配置值传进来。 */
97
+ limits: CompactLimits | undefined,
98
+ /** 爆窗重试用:忽略「历史太短」的 noop 检查直接压一次(切点退到 0 时仍放弃)。 */
99
+ force: boolean | undefined,
100
+ /** 摘要前置裁剪(T19);不传用缺省口径(不落盘、只按预算截断)。 */
101
+ prune: PruneOptions | undefined,
102
+ /**
103
+ * 复用主对话前缀的两样东西(摘要调用因此命中服务端 KV 缓存,对齐 dsh summarizer):
104
+ * system = 与主对话一字不差的系统提示词;tools = 主对话那份工具目录(缺省不发)。
105
+ * 必传:没有它摘要调用就是独立形状,缓存的账对不上。
106
+ */
107
+ context: {
108
+ system: string;
109
+ tools?: readonly ToolSchema[];
110
+ }): Promise<CompactOutcome>;