@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,329 @@
1
+ /**
2
+ * spill:工具输出超阈值时落盘,回给模型的只有头几行、文件路径与续读写法。
3
+ *
4
+ * 为什么要有这一层:bash 自己把结果腰斩在 8000 字符(core/tools/bash.ts:19),
5
+ * read 与 grep 一次也能吐几千行;这些内容塞进上下文既贵,又把真正的对话挤出去。
6
+ * 落盘之后尾巴还在盘上,模型想接着看就照预览里那行 read 去取——是「溢出到文件」,
7
+ * 不是「腰斩丢掉」。落盘命名、目录 0700 / 文件 0600、按 mtime 与总量清理这三样
8
+ * 照 dsh 的 `packages/spill/spill-local`。
9
+ *
10
+ * 落盘的是**已遮红**的文本:遮红观察者排在前(order 10),溢出观察者排在后(order 50),
11
+ * 为什么必须这个次序写在 plugins/spill.ts 的模块注释里。
12
+ *
13
+ * @module dsc/core/spill
14
+ */
15
+ import { closeSync, lstatSync, mkdirSync, openSync, readdirSync, unlinkSync, writeSync } from 'node:fs';
16
+ import { randomBytes } from 'node:crypto';
17
+ import { homedir } from 'node:os';
18
+ import { join, resolve } from 'node:path';
19
+ import { resolvePluginConfig } from './plugin-registry.js';
20
+ import { dscPath } from './path-policy.js';
21
+ /** 插件在条目树(`~/.dsc/plugins.json`)里的键。 */
22
+ const CONFIG_KEY = 'spill';
23
+ /**
24
+ * 单文件截断时给说明文字留的字节预算。
25
+ * 说明里有行号,长度随行号位数浮动,256 字节足够任何一位数行号写满。
26
+ */
27
+ const TRUNCATION_RESERVE_BYTES = 256;
28
+ /** 每个可调值的合法区间:设置页的 min/max 与这里的夹取共用一份,免得两处对不上。 */
29
+ export const SPILL_RANGES = {
30
+ thresholdChars: { min: 200, max: 4_000_000 },
31
+ keepLines: { min: 1, max: 500 },
32
+ readChunkLines: { min: 1, max: 2000 },
33
+ maxBytes: { min: 4_096, max: 268_435_456 },
34
+ retentionDays: { min: 1, max: 3_650 },
35
+ // 目录总量的下限给 64 KB:比这更小连一份普通输出都存不住,清理会一直在删刚写的文件
36
+ maxTotalBytes: { min: 65_536, max: 8_589_934_592 },
37
+ };
38
+ /**
39
+ * 缺省值。放着让用户改,不是硬编码的裁决。
40
+ *
41
+ * 阈值取 4000 而不是 8000:bash 折在 8000 以内的输出里仍有 4000~8000 字符的整段,
42
+ * read / grep 更是动辄几千行,这些一样该落盘;再小就会把普通的命令回显也送进文件。
43
+ */
44
+ export const SPILL_DEFAULTS = {
45
+ thresholdChars: 4000,
46
+ keepLines: 30,
47
+ readChunkLines: 200,
48
+ maxBytes: 1_048_576,
49
+ retentionDays: 7,
50
+ maxTotalBytes: 67_108_864,
51
+ dir: dscPath('spill'),
52
+ };
53
+ /** 夹到区间内的整数;认不出的值退回缺省。 */
54
+ function clampInt(value, range, fallback) {
55
+ const num = Number(value);
56
+ return Number.isFinite(num) ? Math.min(Math.max(Math.round(num), range.min), range.max) : fallback;
57
+ }
58
+ /** `~` 开头换成用户目录;其余原样返回(相对路径交给后面的文件操作按 cwd 解析)。 */
59
+ function expandHome(text) {
60
+ if (text === '~')
61
+ return homedir();
62
+ if (text.startsWith('~/') || text.startsWith('~\\'))
63
+ return join(homedir(), text.slice(2));
64
+ return text;
65
+ }
66
+ /**
67
+ * 逐项夹到 {@link SPILL_RANGES} 的范围里,写错类型就用缺省值。
68
+ * 单个值越界不该让整条工具链停下,所以这里不抛错;真有问题在设置页上看得见。
69
+ *
70
+ * @param raw - 磁盘上那份配置(`resolvePluginConfig` 的返回值)。
71
+ * @returns 可以直接用的配置。
72
+ */
73
+ export function parseSpillConfig(raw) {
74
+ return {
75
+ thresholdChars: clampInt(raw.thresholdChars, SPILL_RANGES.thresholdChars, SPILL_DEFAULTS.thresholdChars),
76
+ keepLines: clampInt(raw.keepLines, SPILL_RANGES.keepLines, SPILL_DEFAULTS.keepLines),
77
+ readChunkLines: clampInt(raw.readChunkLines, SPILL_RANGES.readChunkLines, SPILL_DEFAULTS.readChunkLines),
78
+ maxBytes: clampInt(raw.maxBytes, SPILL_RANGES.maxBytes, SPILL_DEFAULTS.maxBytes),
79
+ retentionDays: clampInt(raw.retentionDays, SPILL_RANGES.retentionDays, SPILL_DEFAULTS.retentionDays),
80
+ maxTotalBytes: clampInt(raw.maxTotalBytes, SPILL_RANGES.maxTotalBytes, SPILL_DEFAULTS.maxTotalBytes),
81
+ dir: expandHome(typeof raw.dir === 'string' && raw.dir.trim() !== '' ? raw.dir.trim() : SPILL_DEFAULTS.dir),
82
+ };
83
+ }
84
+ /**
85
+ * 取这个插件此刻该用的配置:装配时传进来的那份作底,`~/.dsc/plugins.json` 上那份覆盖它。
86
+ * 每次用值都现调(不是挂载时读一次),所以设置里改完不必重启宿主。
87
+ *
88
+ * @param passed - 插件 `apply(ctx, passed)` 的第二参数;不是对象就当没给。
89
+ * @returns 当前配置。
90
+ */
91
+ export function readSpillConfig(passed) {
92
+ return parseSpillConfig(resolvePluginConfig(CONFIG_KEY, passed));
93
+ }
94
+ /** 会话 id 当不可信文本处理:只留文件系统安全的字符再截断,免得路径穿越或撞上文件名长度上限。 */
95
+ function safeSegment(raw) {
96
+ const safe = raw.replace(/[^A-Za-z0-9._-]/g, '_');
97
+ return safe === '' ? 'session' : safe.slice(0, 64);
98
+ }
99
+ /** 文件名 = 会话 id + ISO 时刻 + 随机尾;冒号与点在 Windows 上是非法字符,换成短横。 */
100
+ function spillFileName(sessionId) {
101
+ const stamp = new Date().toISOString().replace(/[:.]/g, '-');
102
+ return `${safeSegment(sessionId)}-${stamp}-${randomBytes(4).toString('hex')}.log`;
103
+ }
104
+ /** 按 UTF-8 字节切一段字符串,切点落在码点边界上(不产生半个字符)。 */
105
+ function sliceUtf8(text, maxBytes) {
106
+ let bytes = 0;
107
+ let end = 0;
108
+ for (const char of text) {
109
+ const size = Buffer.byteLength(char, 'utf8');
110
+ if (bytes + size > maxBytes)
111
+ break;
112
+ bytes += size;
113
+ end += char.length;
114
+ }
115
+ return text.slice(0, end);
116
+ }
117
+ /**
118
+ * 按整行取前几行,让正文落在字节预算内。
119
+ * 第一行本身就超预算时退一步切这一行——总比写一个空文件强。
120
+ */
121
+ function headWithinBudget(lines, budget) {
122
+ const first = lines[0];
123
+ if (first === undefined)
124
+ return { body: '', keptLines: 0 };
125
+ if (Buffer.byteLength(first, 'utf8') > budget)
126
+ return { body: sliceUtf8(first, budget), keptLines: 1 };
127
+ const kept = [];
128
+ let used = 0;
129
+ for (const line of lines) {
130
+ const bytes = Buffer.byteLength(line, 'utf8') + 1;
131
+ if (used + bytes > budget)
132
+ break;
133
+ kept.push(line);
134
+ used += bytes;
135
+ }
136
+ return { body: kept.join('\n'), keptLines: kept.length };
137
+ }
138
+ /** 截断位置写在文件末尾:模型读到这儿就知道后面还有多少行没落盘。 */
139
+ function truncationNote(kept, total, maxBytes) {
140
+ return `\n…(超过单文件上限 ${String(maxBytes)} 字节,只写了前 ${String(kept)} 行,原文共 ${String(total)} 行;第 ${String(kept + 1)} 行起的 ${String(total - kept)} 行没有落盘)`;
141
+ }
142
+ /** 建新文件并把正文写进去:目录 0700、文件 0600(同机其他用户读不到)。 */
143
+ function createSpillFile(sessionId, config, body) {
144
+ for (let attempt = 0; attempt < 3; attempt += 1) {
145
+ const path = join(config.dir, spillFileName(sessionId));
146
+ let handle;
147
+ try {
148
+ handle = openSync(path, 'wx', 0o600);
149
+ }
150
+ catch (error) {
151
+ // 同一毫秒里连写两次会撞名(随机尾把概率压到极低),重掷一次即可;其余 IO 错误照抛。
152
+ if (error.code === 'EEXIST')
153
+ continue;
154
+ throw error;
155
+ }
156
+ try {
157
+ writeSync(handle, body);
158
+ }
159
+ finally {
160
+ closeSync(handle);
161
+ }
162
+ return { path, bytes: Buffer.byteLength(body, 'utf8') };
163
+ }
164
+ throw new Error(`连续三次都没能建出溢出文件(目录 ${config.dir})`);
165
+ }
166
+ /**
167
+ * 把一次工具输出写到溢出目录,返回落盘结果。
168
+ *
169
+ * 超过单文件上限时按**整行**截断,并在末尾写明截断位置(第几行起没写);
170
+ * 单行就超上限那种极端情况切这一行本身,保证文件里至少有开头。
171
+ *
172
+ * @param sessionId - 会话 id,进文件名。取不到也照写,用 `session` 兜底。
173
+ * @param text - 要落盘的文本(调用方保证它已经过遮红)。
174
+ * @param config - 当前配置。
175
+ * @returns 文件路径、字节数与截断情况。
176
+ * @throws 目录建不出来或文件写不进去时抛错(调用方退回原文,别把工具结果弄丢)。
177
+ */
178
+ export function writeSpill(sessionId, text, config) {
179
+ mkdirSync(config.dir, { recursive: true, mode: 0o700 });
180
+ const lines = text.split('\n');
181
+ let body = text;
182
+ let keptLines = lines.length;
183
+ let truncated = false;
184
+ if (Buffer.byteLength(text, 'utf8') > config.maxBytes) {
185
+ const head = headWithinBudget(lines, Math.max(1, config.maxBytes - TRUNCATION_RESERVE_BYTES));
186
+ body = `${head.body}${truncationNote(head.keptLines, lines.length, config.maxBytes)}`;
187
+ keptLines = head.keptLines;
188
+ truncated = true;
189
+ }
190
+ const written = createSpillFile(sessionId, config, body);
191
+ return { ...written, truncated, keptLines, totalLines: lines.length };
192
+ }
193
+ /**
194
+ * 回给模型的那段:前几行 + 完整路径 + 一句可以直接照抄的续读写法。
195
+ *
196
+ * @param path - 落盘文件的绝对路径。
197
+ * @param text - 溢出的原文;这里只取前几行,尾巴绝不出现。
198
+ * @param config - 当前配置(决定显示几行、续读一次读几行)。
199
+ * @param written - {@link writeSpill} 的结果;文件本身也被截断过时把这件事一并说明。
200
+ * @returns 替换原文的那段文本。
201
+ */
202
+ export function spillPreview(path, text, config, written) {
203
+ const lines = text.split('\n');
204
+ // 文件只写了一部分(截断)时,预览也别显示文件里没有的行
205
+ const available = written !== undefined && written.truncated ? Math.min(lines.length, written.keptLines) : lines.length;
206
+ const head = lines.slice(0, Math.min(config.keepLines, available));
207
+ const shown = head.length;
208
+ const missing = lines.length - shown;
209
+ const more = missing > 0 ? `\n…(这里只显示前 ${String(shown)} 行,还有 ${String(missing)} 行)` : '';
210
+ const cut = written !== undefined && written.truncated
211
+ ? `\n(文件本身按 ${String(config.maxBytes)} 字节上限截断,只写了前 ${String(written.keptLines)} 行)`
212
+ : '';
213
+ const pointer = `[完整输出已落盘:${path}\n接着读:read(path="${path}", offset=${String(shown + 1)}, limit=${String(config.readChunkLines)})]`;
214
+ return `${head.join('\n')}${more}${cut}\n\n${pointer}`;
215
+ }
216
+ /**
217
+ * 一次完整的溢出:先落盘,再生成回给模型的那段预览。
218
+ * 插件与自检脚本共用这一条路径,所以「先遮红后落盘」验的是顺序,不是两份实现的差别。
219
+ *
220
+ * @param sessionId - 会话 id,进文件名。
221
+ * @param text - 要溢出的文本。
222
+ * @param config - 当前配置。
223
+ * @returns 预览文本与落盘结果。
224
+ */
225
+ export function spillText(sessionId, text, config) {
226
+ const written = writeSpill(sessionId, text, config);
227
+ return { text: spillPreview(written.path, text, config, written), written };
228
+ }
229
+ /**
230
+ * 列目录里已经落盘的溢出文件。
231
+ * 用 lstat 看一眼:符号链接与子目录一律不算(既不跟过去,也不当成溢出文件删)。
232
+ *
233
+ * @param dir - 溢出目录。
234
+ * @returns 普通文件的路径、mtime 与字节数;目录不存在返回空数组。
235
+ */
236
+ export function listSpillFiles(dir) {
237
+ let names;
238
+ try {
239
+ names = readdirSync(dir);
240
+ }
241
+ catch {
242
+ // 目录还不存在 = 从来没溢出过(也可能刚被别的进程删掉):这不是错误
243
+ return [];
244
+ }
245
+ const files = [];
246
+ for (const name of names) {
247
+ const path = join(dir, name);
248
+ try {
249
+ const stats = lstatSync(path);
250
+ if (!stats.isFile())
251
+ continue;
252
+ files.push({ path, mtimeMs: stats.mtimeMs, bytes: stats.size });
253
+ }
254
+ catch {
255
+ // 目录边扫边变(这一项刚被删掉)或权限不够:跳过这一项,别让整次清理失败
256
+ continue;
257
+ }
258
+ }
259
+ return files;
260
+ }
261
+ /** 比路径时统一大小写与分隔符(Windows 上大小写不敏感,`\` 与 `/` 混着写很常见)。 */
262
+ function normalizePath(path) {
263
+ const full = resolve(path);
264
+ return process.platform === 'win32' ? full.toLowerCase() : full;
265
+ }
266
+ /** 删一个文件并记账;删不掉就记下原因,返回 false(调用方据此别减错总量)。 */
267
+ function removeOne(file, result) {
268
+ try {
269
+ unlinkSync(file.path);
270
+ }
271
+ catch (error) {
272
+ // 权限不够、被杀毒软件占着:记下来继续扫,一个文件卡住不该让整次清理停下
273
+ result.failed.push({ path: file.path, reason: error instanceof Error ? error.message : String(error) });
274
+ return false;
275
+ }
276
+ result.removed.push(file.path);
277
+ result.removedBytes += file.bytes;
278
+ return true;
279
+ }
280
+ /**
281
+ * 扫一遍溢出目录:先删 mtime 超过保留天数的,再从最旧的开始删到总字节数落回上限内。
282
+ *
283
+ * 三条边界:只碰普通文件(符号链接与子目录不跟、不删),
284
+ * 刚写的那个文件(keepPath)怎么都不删,目录不存在就当已经清干净。
285
+ *
286
+ * @param config - 当前配置(目录、保留天数、总量上限)。
287
+ * @param keepPath - 这次要保住的文件(一般是刚落盘的那份);不传就没有例外。
288
+ * @returns 删了什么、还剩多少、哪些没删掉。
289
+ */
290
+ export function sweepSpillDir(config, keepPath) {
291
+ const result = { removed: [], removedBytes: 0, keptFiles: 0, keptBytes: 0, failed: [] };
292
+ const protectedPath = keepPath === undefined ? undefined : normalizePath(keepPath);
293
+ const cutoff = Date.now() - config.retentionDays * 86_400_000;
294
+ const survivors = [];
295
+ for (const file of listSpillFiles(config.dir)) {
296
+ const protect = protectedPath !== undefined && normalizePath(file.path) === protectedPath;
297
+ // 刚写的那份不按年龄删:模型手上可能正拿着它的路径在续读
298
+ if (!protect && file.mtimeMs < cutoff)
299
+ removeOne(file, result);
300
+ else
301
+ survivors.push({ ...file, protect });
302
+ }
303
+ survivors.sort((left, right) => left.mtimeMs - right.mtimeMs);
304
+ let total = survivors.reduce((sum, file) => sum + file.bytes, 0);
305
+ let kept = 0;
306
+ for (const file of survivors) {
307
+ if (file.protect || total <= config.maxTotalBytes) {
308
+ kept += 1;
309
+ continue;
310
+ }
311
+ if (removeOne(file, result))
312
+ total -= file.bytes;
313
+ else
314
+ kept += 1;
315
+ }
316
+ result.keptFiles = kept;
317
+ result.keptBytes = total;
318
+ return result;
319
+ }
320
+ /** 字节数换成人看的写法(设置页与清理结果里用)。 */
321
+ export function formatBytes(bytes) {
322
+ if (bytes < 1024)
323
+ return `${String(bytes)} 字节`;
324
+ if (bytes < 1_048_576)
325
+ return `${(bytes / 1024).toFixed(1)} KB`;
326
+ if (bytes < 1_073_741_824)
327
+ return `${(bytes / 1_048_576).toFixed(1)} MB`;
328
+ return `${(bytes / 1_073_741_824).toFixed(2)} GB`;
329
+ }
@@ -0,0 +1,45 @@
1
+ /**
2
+ * 快照片段注册表:界面快照里每一块「某个功能点的状态投影」由那个功能点自己登记。
3
+ *
4
+ * 为什么要有这一层:装配快照的那一层(transcript)原先 inject 了模式、任务面等五个服务,
5
+ * 一行读一个功能,加一个新状态面就得回去改它。改成注册表之后,
6
+ * 装配层只认识「注册表」这一件事,模式登记模式那一块、清单登记清单那一块。
7
+ *
8
+ * 读取时的两条兜底:
9
+ * - 生产投影抛错 → 沿用上一次的值(一个插件算错不该把整帧快照弄没);
10
+ * - 没有注册者 → 该 id 在快照里缺席,界面按空处理。
11
+ *
12
+ * @module dsc/core/surface-registry
13
+ */
14
+ /** 一片界面投影:id + 取当前值(每次装配快照时调用,所以不必通知谁)。 */
15
+ export interface SurfaceContribution<T = unknown> {
16
+ id: string;
17
+ read: () => T;
18
+ }
19
+ /**
20
+ * 注册表本体:注册返回退订函数,插件卸载后下一帧快照里就没有它了。
21
+ * 键顺序 = 注册顺序,快照里的条目因此每次装配都稳定(界面不会莫名重排)。
22
+ *
23
+ * @typeParam S - 这一层要产出的快照类型(dsc 里就是 `RuntimeSurfaces`)。
24
+ * 类型参数让调用方拿到的就是那个类型本身,不必再自己转一次;代价是它得保证
25
+ * 在第一次产帧之前把该声明的片段都登记齐——dsc 的装配顺序保证了这点:
26
+ * 产帧的是 transcript,而它只在界面真的来取帧时才装配,那时 base 插件早就挂完了。
27
+ */
28
+ export declare class SurfaceRegistry<S extends object = Record<string, unknown>> {
29
+ private readonly contributions;
30
+ /** id → 上一次成功算出的投影(生产函数抛错时兜底)。 */
31
+ private readonly lastGood;
32
+ /**
33
+ * 登记一片投影;同 id 后注册者顶掉先注册者,退订只撤自己这一份。
34
+ * @param contribution - 这片投影的归属键与取法。
35
+ * @returns 退订函数。
36
+ */
37
+ register<K extends keyof S & string>(contribution: SurfaceContribution<S[K]>): () => void;
38
+ /** 已登记的片段 id(按注册顺序,自检与诊断用)。 */
39
+ get ids(): string[];
40
+ /**
41
+ * 装配当前所有投影(注册顺序)。
42
+ * @returns 快照要用的那一块;未登记的键缺席(界面按空处理)
43
+ */
44
+ build(): S;
45
+ }
@@ -0,0 +1,67 @@
1
+ /**
2
+ * 快照片段注册表:界面快照里每一块「某个功能点的状态投影」由那个功能点自己登记。
3
+ *
4
+ * 为什么要有这一层:装配快照的那一层(transcript)原先 inject 了模式、任务面等五个服务,
5
+ * 一行读一个功能,加一个新状态面就得回去改它。改成注册表之后,
6
+ * 装配层只认识「注册表」这一件事,模式登记模式那一块、清单登记清单那一块。
7
+ *
8
+ * 读取时的两条兜底:
9
+ * - 生产投影抛错 → 沿用上一次的值(一个插件算错不该把整帧快照弄没);
10
+ * - 没有注册者 → 该 id 在快照里缺席,界面按空处理。
11
+ *
12
+ * @module dsc/core/surface-registry
13
+ */
14
+ /**
15
+ * 注册表本体:注册返回退订函数,插件卸载后下一帧快照里就没有它了。
16
+ * 键顺序 = 注册顺序,快照里的条目因此每次装配都稳定(界面不会莫名重排)。
17
+ *
18
+ * @typeParam S - 这一层要产出的快照类型(dsc 里就是 `RuntimeSurfaces`)。
19
+ * 类型参数让调用方拿到的就是那个类型本身,不必再自己转一次;代价是它得保证
20
+ * 在第一次产帧之前把该声明的片段都登记齐——dsc 的装配顺序保证了这点:
21
+ * 产帧的是 transcript,而它只在界面真的来取帧时才装配,那时 base 插件早就挂完了。
22
+ */
23
+ export class SurfaceRegistry {
24
+ contributions = new Map();
25
+ /** id → 上一次成功算出的投影(生产函数抛错时兜底)。 */
26
+ lastGood = new Map();
27
+ /**
28
+ * 登记一片投影;同 id 后注册者顶掉先注册者,退订只撤自己这一份。
29
+ * @param contribution - 这片投影的归属键与取法。
30
+ * @returns 退订函数。
31
+ */
32
+ register(contribution) {
33
+ this.contributions.set(contribution.id, contribution);
34
+ this.lastGood.delete(contribution.id);
35
+ return () => {
36
+ if (this.contributions.get(contribution.id) === contribution) {
37
+ this.contributions.delete(contribution.id);
38
+ this.lastGood.delete(contribution.id);
39
+ }
40
+ };
41
+ }
42
+ /** 已登记的片段 id(按注册顺序,自检与诊断用)。 */
43
+ get ids() {
44
+ return [...this.contributions.keys()];
45
+ }
46
+ /**
47
+ * 装配当前所有投影(注册顺序)。
48
+ * @returns 快照要用的那一块;未登记的键缺席(界面按空处理)
49
+ */
50
+ build() {
51
+ const out = {};
52
+ for (const [id, contribution] of this.contributions) {
53
+ try {
54
+ const value = contribution.read();
55
+ this.lastGood.set(id, value);
56
+ out[id] = value;
57
+ }
58
+ catch {
59
+ // 一个功能点算崩了不该让整帧快照没了:留旧值,界面照旧画得出来。
60
+ if (this.lastGood.has(id))
61
+ out[id] = this.lastGood.get(id);
62
+ }
63
+ }
64
+ // 键就是注册时那个 K,值也是 S[K];这里只是把「逐键登记」这个事实告诉编译器。
65
+ return out;
66
+ }
67
+ }
@@ -0,0 +1,95 @@
1
+ /** 团队目录(任务板 + 信箱)。 */
2
+ export declare const TEAM_ROOT: string;
3
+ /** 任务板目录(每个会话一块板)。 */
4
+ export declare const BOARDS_DIR: string;
5
+ /** 信箱目录(每个队友一个 jsonl)。 */
6
+ export declare const INBOX_DIR: string;
7
+ /**
8
+ * 队友干完活投给父会话的那条汇报,正文固定以这个开头。
9
+ *
10
+ * 为什么要有它、而不是两处各写一份字面量:adapter 靠这个前缀把这条消息认出来
11
+ * (跟压缩摘要的 `SUMMARY_BANNER` 同一个套路),认出后给条目打 `internal` 标记,
12
+ * 界面就不再把它当「人打的字」渲染(对照 dsh 的 turn-trigger 节点:非人发起的
13
+ * 唤醒消息渲染成一行可展开的「子任务状态更新」,不是用户气泡)。
14
+ * 插件与 adapter 共用同一个常量,改一处漏一处就会出现「汇报又原样冒出来」。
15
+ */
16
+ export declare const TEAMMATE_REPORT_OPEN = "<teammate-report ";
17
+ /**
18
+ * 审查队友收工投给发起会话的那条 findings,正文固定以这个开头。
19
+ *
20
+ * 与 {@link TEAMMATE_REPORT_OPEN} 同一个套路、同一份理由:adapter 靠前缀认出它、
21
+ * 给条目打 `internal` 标记,界面就不把整段 `<review-findings …>` 当「人打的字」
22
+ * 原样渲染(那是审查队友的机器汇报,不是用户发言)。插件与 adapter 共用这一份字面量。
23
+ */
24
+ export declare const REVIEW_FINDINGS_OPEN = "<review-findings ";
25
+ /** 任务状态机:pending → in_progress → completed,只有三态,没有中间态。 */
26
+ export type TaskStatus = 'pending' | 'in_progress' | 'completed';
27
+ export interface TeamTask {
28
+ id: string;
29
+ subject: string;
30
+ description: string;
31
+ status: TaskStatus;
32
+ /** 认领它的队友名;null = 没人认领。 */
33
+ owner: string | null;
34
+ /** 依赖的任务 id;全部 completed 才算 ready。 */
35
+ blockedBy: string[];
36
+ /** 打算改的路径前缀(只用于重叠告警,不是锁)。 */
37
+ writeScopes: string[];
38
+ createdAt: number;
39
+ updatedAt: number;
40
+ }
41
+ export interface TeamBoard {
42
+ version: 1;
43
+ /** 每次成功变更 +1;变更方必须报出自己看到的版本,不匹配就拒绝(CAS)。 */
44
+ revision: number;
45
+ tasks: TeamTask[];
46
+ }
47
+ /** 一个会话的任务板文件路径(会话 id 只出现在 uuid 里,仍按文件名安全字符再滤一遍)。 */
48
+ export declare function boardFile(sessionId: string): string;
49
+ /** 读一块任务板(文件缺失或损坏都退回空板,绝不因为板子坏了起不来)。 */
50
+ export declare function readBoard(sessionId: string): TeamBoard;
51
+ /** 路径前缀规范化:统一成正斜杠、去掉首尾斜杠,空串表示「整个工作目录」。 */
52
+ export declare function normalizeScope(scope: string): string;
53
+ /**
54
+ * 这些作用域会不会碰到别人正在改的地方。
55
+ * @param excludeId - 跟本任务自己比没有意义,跳过这个 id。
56
+ */
57
+ export declare function scopeWarnings(board: TeamBoard, scopes: readonly string[], excludeId: string): string[];
58
+ /** 一个任务现在能不能开工(pending 且所有依赖都已 completed)。 */
59
+ export declare function isReady(board: TeamBoard, task: TeamTask): boolean;
60
+ /** 新建任务(不需要 CAS:新增不会覆盖别人的改动)。带上写回后的板,紧接着要认领它才不用再读一遍。 */
61
+ export declare function boardCreate(sessionId: string, input: {
62
+ subject: string;
63
+ description?: string;
64
+ owner?: string;
65
+ blockedBy?: readonly string[];
66
+ writeScopes?: readonly string[];
67
+ }): {
68
+ task: TeamTask;
69
+ warnings: string[];
70
+ board: TeamBoard;
71
+ };
72
+ /** 任务板变更动作。 */
73
+ export type BoardAction = 'claim' | 'release' | 'complete' | 'reopen' | 'set_dependencies' | 'delete';
74
+ /**
75
+ * 改一条任务。调用方必须带上自己看到的 board revision,
76
+ * 不匹配就抛错——两个队友同时抢同一个任务是常态,先到先得靠的就是这一条。
77
+ * @param payload.owner - claim 时填认领者名字。
78
+ * @param payload.blockedBy - set_dependencies 时填新的依赖清单。
79
+ */
80
+ export declare function boardUpdate(sessionId: string, id: string, expectedRevision: number, action: BoardAction, payload?: {
81
+ owner?: string;
82
+ blockedBy?: readonly string[];
83
+ }): {
84
+ board: TeamBoard;
85
+ task: TeamTask;
86
+ };
87
+ /** 把一块任务板清空(设置页「清空任务板」按钮用;不动队友的运行记录)。 */
88
+ export declare function resetBoard(sessionId: string): number;
89
+ /**
90
+ * 往传话台账追加一条(调用方负责紧接着把它投给那个队友的循环)。
91
+ * @throws 内容为空,或超过单条长度上限时抛错。
92
+ */
93
+ export declare function inboxAppend(teammate: string, text: string): void;
94
+ /** 读一个队友信箱里的全部消息(按写入顺序)。 */
95
+ export declare function inboxRead(teammate: string): string[];