@waq666/pneuma 0.0.0-stage → 0.7.0

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 (687) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +144 -2
  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 +13 -0
  16. package/lib/app/App.js +1498 -0
  17. package/lib/app/ApprovalCard.d.ts +12 -0
  18. package/lib/app/ApprovalCard.js +76 -0
  19. package/lib/app/AskCard.d.ts +20 -0
  20. package/lib/app/AskCard.js +45 -0
  21. package/lib/app/ChatView.d.ts +32 -0
  22. package/lib/app/ChatView.js +198 -0
  23. package/lib/app/Composer.d.ts +50 -0
  24. package/lib/app/Composer.js +282 -0
  25. package/lib/app/DiffBlock.d.ts +6 -0
  26. package/lib/app/DiffBlock.js +37 -0
  27. package/lib/app/MarkdownView.d.ts +6 -0
  28. package/lib/app/MarkdownView.js +99 -0
  29. package/lib/app/ModelPicker.d.ts +7 -0
  30. package/lib/app/ModelPicker.js +18 -0
  31. package/lib/app/PlanReviewCard.d.ts +13 -0
  32. package/lib/app/PlanReviewCard.js +54 -0
  33. package/lib/app/PresetPicker.d.ts +11 -0
  34. package/lib/app/PresetPicker.js +19 -0
  35. package/lib/app/PreviewOverlay.d.ts +14 -0
  36. package/lib/app/PreviewOverlay.js +22 -0
  37. package/lib/app/SessionPicker.d.ts +43 -0
  38. package/lib/app/SessionPicker.js +56 -0
  39. package/lib/app/SettingsOverlay.d.ts +32 -0
  40. package/lib/app/SettingsOverlay.js +157 -0
  41. package/lib/app/SkillsPicker.d.ts +7 -0
  42. package/lib/app/SkillsPicker.js +19 -0
  43. package/lib/app/StatusBar.d.ts +22 -0
  44. package/lib/app/StatusBar.js +272 -0
  45. package/lib/app/TaskStrips.d.ts +13 -0
  46. package/lib/app/TaskStrips.js +40 -0
  47. package/lib/app/ToolCard.d.ts +5 -0
  48. package/lib/app/ToolCard.js +40 -0
  49. package/lib/app/TranscriptOverlay.d.ts +12 -0
  50. package/lib/app/TranscriptOverlay.js +17 -0
  51. package/lib/app/Welcome.d.ts +6 -0
  52. package/lib/app/Welcome.js +66 -0
  53. package/lib/app/attach.d.ts +16 -0
  54. package/lib/app/attach.js +58 -0
  55. package/lib/app/click.d.ts +27 -0
  56. package/lib/app/click.js +89 -0
  57. package/lib/app/clipboard-image.d.ts +11 -0
  58. package/lib/app/clipboard-image.js +66 -0
  59. package/lib/app/cursor.d.ts +4 -0
  60. package/lib/app/cursor.js +24 -0
  61. package/lib/app/hello.d.ts +11 -0
  62. package/lib/app/hello.js +8 -0
  63. package/lib/app/history-store.d.ts +4 -0
  64. package/lib/app/history-store.js +41 -0
  65. package/lib/app/image-blocks.d.ts +12 -0
  66. package/lib/app/image-blocks.js +125 -0
  67. package/lib/app/markdown.d.ts +54 -0
  68. package/lib/app/markdown.js +189 -0
  69. package/lib/app/settings-model.d.ts +69 -0
  70. package/lib/app/settings-model.js +114 -0
  71. package/lib/app/theme.d.ts +166 -0
  72. package/lib/app/theme.js +141 -0
  73. package/lib/boot.d.ts +1 -0
  74. package/lib/boot.js +34 -0
  75. package/lib/commands.d.ts +49 -0
  76. package/lib/commands.js +115 -0
  77. package/lib/contract.d.ts +1973 -0
  78. package/lib/contract.js +36 -0
  79. package/lib/core/agent-roles.d.ts +52 -0
  80. package/lib/core/agent-roles.js +274 -0
  81. package/lib/core/approval-floor.d.ts +183 -0
  82. package/lib/core/approval-floor.js +679 -0
  83. package/lib/core/approval.d.ts +42 -0
  84. package/lib/core/approval.js +8 -0
  85. package/lib/core/audit.d.ts +61 -0
  86. package/lib/core/audit.js +59 -0
  87. package/lib/core/boot-notices.d.ts +6 -0
  88. package/lib/core/boot-notices.js +61 -0
  89. package/lib/core/cdp/actions.d.ts +182 -0
  90. package/lib/core/cdp/actions.js +649 -0
  91. package/lib/core/cdp/launch.d.ts +192 -0
  92. package/lib/core/cdp/launch.js +491 -0
  93. package/lib/core/cdp/snapshot.d.ts +139 -0
  94. package/lib/core/cdp/snapshot.js +316 -0
  95. package/lib/core/cdp/transport.d.ts +160 -0
  96. package/lib/core/cdp/transport.js +359 -0
  97. package/lib/core/command-policy.d.ts +108 -0
  98. package/lib/core/command-policy.js +580 -0
  99. package/lib/core/commands-completion.d.ts +78 -0
  100. package/lib/core/commands-completion.js +167 -0
  101. package/lib/core/compact-anchors.d.ts +76 -0
  102. package/lib/core/compact-anchors.js +284 -0
  103. package/lib/core/compact.d.ts +110 -0
  104. package/lib/core/compact.js +210 -0
  105. package/lib/core/config-store.d.ts +38 -0
  106. package/lib/core/config-store.js +307 -0
  107. package/lib/core/config.d.ts +36 -0
  108. package/lib/core/config.js +124 -0
  109. package/lib/core/connection-test.d.ts +60 -0
  110. package/lib/core/connection-test.js +84 -0
  111. package/lib/core/desktop-control.d.ts +298 -0
  112. package/lib/core/desktop-control.js +1311 -0
  113. package/lib/core/diff-text.d.ts +74 -0
  114. package/lib/core/diff-text.js +257 -0
  115. package/lib/core/dock-browser.d.ts +137 -0
  116. package/lib/core/dock-browser.js +146 -0
  117. package/lib/core/dock-ops.d.ts +59 -0
  118. package/lib/core/dock-ops.js +104 -0
  119. package/lib/core/dock-session.d.ts +39 -0
  120. package/lib/core/dock-session.js +28 -0
  121. package/lib/core/dsh-compat/hook.d.ts +18 -0
  122. package/lib/core/dsh-compat/hook.js +52 -0
  123. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  124. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  125. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  126. package/lib/core/dsh-compat/tools-facade.js +108 -0
  127. package/lib/core/err-text.d.ts +13 -0
  128. package/lib/core/err-text.js +15 -0
  129. package/lib/core/events.d.ts +149 -0
  130. package/lib/core/events.js +1 -0
  131. package/lib/core/git-exec.d.ts +23 -0
  132. package/lib/core/git-exec.js +72 -0
  133. package/lib/core/git-info.d.ts +47 -0
  134. package/lib/core/git-info.js +157 -0
  135. package/lib/core/goal.d.ts +89 -0
  136. package/lib/core/goal.js +189 -0
  137. package/lib/core/hooks.d.ts +272 -0
  138. package/lib/core/hooks.js +818 -0
  139. package/lib/core/host-browser-link.d.ts +59 -0
  140. package/lib/core/host-browser-link.js +9 -0
  141. package/lib/core/host-methods.d.ts +25 -0
  142. package/lib/core/host-methods.js +103 -0
  143. package/lib/core/image-diet.d.ts +77 -0
  144. package/lib/core/image-diet.js +127 -0
  145. package/lib/core/learnings/ledger.d.ts +73 -0
  146. package/lib/core/learnings/ledger.js +273 -0
  147. package/lib/core/learnings/skill-write.d.ts +250 -0
  148. package/lib/core/learnings/skill-write.js +854 -0
  149. package/lib/core/learnings/store.d.ts +102 -0
  150. package/lib/core/learnings/store.js +266 -0
  151. package/lib/core/lifecycle-hooks.d.ts +189 -0
  152. package/lib/core/lifecycle-hooks.js +576 -0
  153. package/lib/core/llm.d.ts +272 -0
  154. package/lib/core/llm.js +548 -0
  155. package/lib/core/lockfile.d.ts +17 -0
  156. package/lib/core/lockfile.js +110 -0
  157. package/lib/core/loop.d.ts +185 -0
  158. package/lib/core/loop.js +587 -0
  159. package/lib/core/lsp/client.d.ts +189 -0
  160. package/lib/core/lsp/client.js +690 -0
  161. package/lib/core/lsp/framing.d.ts +84 -0
  162. package/lib/core/lsp/framing.js +181 -0
  163. package/lib/core/lsp/line-shift.d.ts +28 -0
  164. package/lib/core/lsp/line-shift.js +127 -0
  165. package/lib/core/lsp/manager.d.ts +93 -0
  166. package/lib/core/lsp/manager.js +418 -0
  167. package/lib/core/lsp/normalize.d.ts +32 -0
  168. package/lib/core/lsp/normalize.js +139 -0
  169. package/lib/core/lsp/servers.d.ts +106 -0
  170. package/lib/core/lsp/servers.js +352 -0
  171. package/lib/core/lsp/uri.d.ts +76 -0
  172. package/lib/core/lsp/uri.js +179 -0
  173. package/lib/core/market.d.ts +51 -0
  174. package/lib/core/market.js +358 -0
  175. package/lib/core/mcp.d.ts +201 -0
  176. package/lib/core/mcp.js +836 -0
  177. package/lib/core/memory-eval.d.ts +158 -0
  178. package/lib/core/memory-eval.js +215 -0
  179. package/lib/core/memory.d.ts +266 -0
  180. package/lib/core/memory.js +703 -0
  181. package/lib/core/mention.d.ts +57 -0
  182. package/lib/core/mention.js +129 -0
  183. package/lib/core/microcompact.d.ts +48 -0
  184. package/lib/core/microcompact.js +79 -0
  185. package/lib/core/migrate.d.ts +56 -0
  186. package/lib/core/migrate.js +134 -0
  187. package/lib/core/model-caps.d.ts +83 -0
  188. package/lib/core/model-caps.js +150 -0
  189. package/lib/core/model-discovery.d.ts +19 -0
  190. package/lib/core/model-discovery.js +69 -0
  191. package/lib/core/modes.d.ts +72 -0
  192. package/lib/core/modes.js +152 -0
  193. package/lib/core/native-bridge.d.ts +135 -0
  194. package/lib/core/native-bridge.js +563 -0
  195. package/lib/core/path-policy.d.ts +32 -0
  196. package/lib/core/path-policy.js +248 -0
  197. package/lib/core/permission-presets.d.ts +67 -0
  198. package/lib/core/permission-presets.js +75 -0
  199. package/lib/core/plugin-loader.d.ts +36 -0
  200. package/lib/core/plugin-loader.js +294 -0
  201. package/lib/core/plugin-registry.d.ts +113 -0
  202. package/lib/core/plugin-registry.js +256 -0
  203. package/lib/core/prefs.d.ts +82 -0
  204. package/lib/core/prefs.js +372 -0
  205. package/lib/core/presets.d.ts +80 -0
  206. package/lib/core/presets.js +373 -0
  207. package/lib/core/pricing.d.ts +90 -0
  208. package/lib/core/pricing.js +126 -0
  209. package/lib/core/prompt.d.ts +92 -0
  210. package/lib/core/prompt.js +339 -0
  211. package/lib/core/ptc.d.ts +66 -0
  212. package/lib/core/ptc.js +70 -0
  213. package/lib/core/remote/frames.d.ts +91 -0
  214. package/lib/core/remote/frames.js +174 -0
  215. package/lib/core/remote/notify.d.ts +54 -0
  216. package/lib/core/remote/notify.js +77 -0
  217. package/lib/core/remote/owner.d.ts +32 -0
  218. package/lib/core/remote/owner.js +75 -0
  219. package/lib/core/remote/pairing.d.ts +104 -0
  220. package/lib/core/remote/pairing.js +261 -0
  221. package/lib/core/remote/push.d.ts +80 -0
  222. package/lib/core/remote/push.js +222 -0
  223. package/lib/core/remote/store.d.ts +18 -0
  224. package/lib/core/remote/store.js +59 -0
  225. package/lib/core/remote/tickets.d.ts +20 -0
  226. package/lib/core/remote/tickets.js +49 -0
  227. package/lib/core/remote/uploads.d.ts +63 -0
  228. package/lib/core/remote/uploads.js +161 -0
  229. package/lib/core/request-attribution.d.ts +26 -0
  230. package/lib/core/request-attribution.js +86 -0
  231. package/lib/core/request-invariant.d.ts +61 -0
  232. package/lib/core/request-invariant.js +199 -0
  233. package/lib/core/sandbox/backends.d.ts +64 -0
  234. package/lib/core/sandbox/backends.js +194 -0
  235. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  236. package/lib/core/sandbox/execpolicy.js +452 -0
  237. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  238. package/lib/core/sandbox/net-proxy.js +162 -0
  239. package/lib/core/sandbox/policy.d.ts +211 -0
  240. package/lib/core/sandbox/policy.js +559 -0
  241. package/lib/core/sandbox/win/abi.d.ts +161 -0
  242. package/lib/core/sandbox/win/abi.js +169 -0
  243. package/lib/core/sandbox/win/account.d.ts +71 -0
  244. package/lib/core/sandbox/win/account.js +206 -0
  245. package/lib/core/sandbox/win/acl.d.ts +54 -0
  246. package/lib/core/sandbox/win/acl.js +339 -0
  247. package/lib/core/sandbox/win/backend.d.ts +61 -0
  248. package/lib/core/sandbox/win/backend.js +249 -0
  249. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  250. package/lib/core/sandbox/win/doctor.js +272 -0
  251. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  252. package/lib/core/sandbox/win/ffi.js +166 -0
  253. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  254. package/lib/core/sandbox/win/net-abi.js +316 -0
  255. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  256. package/lib/core/sandbox/win/runner-entry.js +391 -0
  257. package/lib/core/sandbox/win/setup.d.ts +60 -0
  258. package/lib/core/sandbox/win/setup.js +986 -0
  259. package/lib/core/sandbox/win/token.d.ts +35 -0
  260. package/lib/core/sandbox/win/token.js +238 -0
  261. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  262. package/lib/core/sandbox/win/wfp.js +200 -0
  263. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  264. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  265. package/lib/core/schedule/rule.d.ts +184 -0
  266. package/lib/core/schedule/rule.js +745 -0
  267. package/lib/core/schedule/runner.d.ts +185 -0
  268. package/lib/core/schedule/runner.js +678 -0
  269. package/lib/core/schedule/store.d.ts +182 -0
  270. package/lib/core/schedule/store.js +455 -0
  271. package/lib/core/secrets.d.ts +41 -0
  272. package/lib/core/secrets.js +150 -0
  273. package/lib/core/session-export.d.ts +18 -0
  274. package/lib/core/session-export.js +73 -0
  275. package/lib/core/session-index.d.ts +159 -0
  276. package/lib/core/session-index.js +683 -0
  277. package/lib/core/session-meta.d.ts +41 -0
  278. package/lib/core/session-meta.js +97 -0
  279. package/lib/core/session.d.ts +356 -0
  280. package/lib/core/session.js +998 -0
  281. package/lib/core/skills.d.ts +60 -0
  282. package/lib/core/skills.js +171 -0
  283. package/lib/core/spill.d.ts +159 -0
  284. package/lib/core/spill.js +329 -0
  285. package/lib/core/surface-registry.d.ts +45 -0
  286. package/lib/core/surface-registry.js +67 -0
  287. package/lib/core/team-board.d.ts +95 -0
  288. package/lib/core/team-board.js +316 -0
  289. package/lib/core/throughput.d.ts +46 -0
  290. package/lib/core/throughput.js +40 -0
  291. package/lib/core/todo-reminder.d.ts +44 -0
  292. package/lib/core/todo-reminder.js +55 -0
  293. package/lib/core/todo.d.ts +81 -0
  294. package/lib/core/todo.js +222 -0
  295. package/lib/core/token-estimate.d.ts +55 -0
  296. package/lib/core/token-estimate.js +82 -0
  297. package/lib/core/tool-guards.d.ts +103 -0
  298. package/lib/core/tool-guards.js +77 -0
  299. package/lib/core/tool-search.d.ts +152 -0
  300. package/lib/core/tool-search.js +311 -0
  301. package/lib/core/tools/bash.d.ts +281 -0
  302. package/lib/core/tools/bash.js +871 -0
  303. package/lib/core/tools/command-runner.d.ts +84 -0
  304. package/lib/core/tools/command-runner.js +68 -0
  305. package/lib/core/tools/fs-tools.d.ts +23 -0
  306. package/lib/core/tools/fs-tools.js +247 -0
  307. package/lib/core/tools/index.d.ts +8 -0
  308. package/lib/core/tools/index.js +4 -0
  309. package/lib/core/tools/sandbox-args.d.ts +51 -0
  310. package/lib/core/tools/sandbox-args.js +90 -0
  311. package/lib/core/tools/search-tools.d.ts +3 -0
  312. package/lib/core/tools/search-tools.js +153 -0
  313. package/lib/core/tools.d.ts +96 -0
  314. package/lib/core/tools.js +53 -0
  315. package/lib/core/ui-boot-source.d.ts +71 -0
  316. package/lib/core/ui-boot-source.js +121 -0
  317. package/lib/core/ui-bundles.d.ts +249 -0
  318. package/lib/core/ui-bundles.js +830 -0
  319. package/lib/core/ui-combo.d.ts +49 -0
  320. package/lib/core/ui-combo.js +55 -0
  321. package/lib/core/ui-events.d.ts +81 -0
  322. package/lib/core/ui-events.js +364 -0
  323. package/lib/core/ui-hmr.d.ts +36 -0
  324. package/lib/core/ui-hmr.js +128 -0
  325. package/lib/core/ui-methods.d.ts +69 -0
  326. package/lib/core/ui-methods.js +341 -0
  327. package/lib/core/ui-route.d.ts +69 -0
  328. package/lib/core/ui-route.js +122 -0
  329. package/lib/core/ui-server.d.ts +75 -0
  330. package/lib/core/ui-server.js +369 -0
  331. package/lib/core/ui-trust.d.ts +47 -0
  332. package/lib/core/ui-trust.js +164 -0
  333. package/lib/core/untrusted.d.ts +30 -0
  334. package/lib/core/untrusted.js +48 -0
  335. package/lib/core/update-check.d.ts +81 -0
  336. package/lib/core/update-check.js +177 -0
  337. package/lib/core/usage-log.d.ts +82 -0
  338. package/lib/core/usage-log.js +306 -0
  339. package/lib/core/version.d.ts +1 -0
  340. package/lib/core/version.js +37 -0
  341. package/lib/core/web-http.d.ts +57 -0
  342. package/lib/core/web-http.js +137 -0
  343. package/lib/core/web-static.d.ts +31 -0
  344. package/lib/core/web-static.js +75 -0
  345. package/lib/headless.d.ts +1 -0
  346. package/lib/headless.js +31 -0
  347. package/lib/host/kernel.d.ts +33 -0
  348. package/lib/host/kernel.js +451 -0
  349. package/lib/index.d.ts +41 -0
  350. package/lib/index.js +35 -0
  351. package/lib/plugins/agent.d.ts +2 -0
  352. package/lib/plugins/agent.js +274 -0
  353. package/lib/plugins/approval-floor.d.ts +2 -0
  354. package/lib/plugins/approval-floor.js +223 -0
  355. package/lib/plugins/approval.d.ts +16 -0
  356. package/lib/plugins/approval.js +674 -0
  357. package/lib/plugins/ask.d.ts +2 -0
  358. package/lib/plugins/ask.js +245 -0
  359. package/lib/plugins/browser.d.ts +68 -0
  360. package/lib/plugins/browser.js +1341 -0
  361. package/lib/plugins/commands.d.ts +23 -0
  362. package/lib/plugins/commands.js +498 -0
  363. package/lib/plugins/compact.d.ts +21 -0
  364. package/lib/plugins/compact.js +274 -0
  365. package/lib/plugins/computer-use.d.ts +47 -0
  366. package/lib/plugins/computer-use.js +539 -0
  367. package/lib/plugins/desktop-dock.d.ts +2 -0
  368. package/lib/plugins/desktop-dock.js +626 -0
  369. package/lib/plugins/dock-browser.d.ts +34 -0
  370. package/lib/plugins/dock-browser.js +765 -0
  371. package/lib/plugins/dsh-compat.d.ts +25 -0
  372. package/lib/plugins/dsh-compat.js +37 -0
  373. package/lib/plugins/file-review.d.ts +108 -0
  374. package/lib/plugins/file-review.js +393 -0
  375. package/lib/plugins/git.d.ts +26 -0
  376. package/lib/plugins/git.js +132 -0
  377. package/lib/plugins/goal.d.ts +20 -0
  378. package/lib/plugins/goal.js +245 -0
  379. package/lib/plugins/guards.d.ts +14 -0
  380. package/lib/plugins/guards.js +18 -0
  381. package/lib/plugins/hooks.d.ts +19 -0
  382. package/lib/plugins/hooks.js +583 -0
  383. package/lib/plugins/host-stdio.d.ts +88 -0
  384. package/lib/plugins/host-stdio.js +317 -0
  385. package/lib/plugins/image-diet.d.ts +17 -0
  386. package/lib/plugins/image-diet.js +85 -0
  387. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  388. package/lib/plugins/lifecycle-hooks.js +338 -0
  389. package/lib/plugins/llm.d.ts +13 -0
  390. package/lib/plugins/llm.js +215 -0
  391. package/lib/plugins/lsp.d.ts +54 -0
  392. package/lib/plugins/lsp.js +608 -0
  393. package/lib/plugins/mcp.d.ts +16 -0
  394. package/lib/plugins/mcp.js +673 -0
  395. package/lib/plugins/memory.d.ts +17 -0
  396. package/lib/plugins/memory.js +858 -0
  397. package/lib/plugins/microcompact.d.ts +18 -0
  398. package/lib/plugins/microcompact.js +119 -0
  399. package/lib/plugins/mode.d.ts +18 -0
  400. package/lib/plugins/mode.js +115 -0
  401. package/lib/plugins/permission-presets.d.ts +18 -0
  402. package/lib/plugins/permission-presets.js +135 -0
  403. package/lib/plugins/plan.d.ts +2 -0
  404. package/lib/plugins/plan.js +192 -0
  405. package/lib/plugins/plugin-manager.d.ts +2 -0
  406. package/lib/plugins/plugin-manager.js +165 -0
  407. package/lib/plugins/presets.d.ts +2 -0
  408. package/lib/plugins/presets.js +182 -0
  409. package/lib/plugins/prompt.d.ts +2 -0
  410. package/lib/plugins/prompt.js +264 -0
  411. package/lib/plugins/ptc.d.ts +2 -0
  412. package/lib/plugins/ptc.js +272 -0
  413. package/lib/plugins/remote/http.d.ts +11 -0
  414. package/lib/plugins/remote/http.js +11 -0
  415. package/lib/plugins/remote/routes.d.ts +24 -0
  416. package/lib/plugins/remote/routes.js +384 -0
  417. package/lib/plugins/remote/types.d.ts +135 -0
  418. package/lib/plugins/remote/types.js +87 -0
  419. package/lib/plugins/remote.d.ts +17 -0
  420. package/lib/plugins/remote.js +1028 -0
  421. package/lib/plugins/runtime-api.d.ts +16 -0
  422. package/lib/plugins/runtime-api.js +99 -0
  423. package/lib/plugins/runtime.d.ts +10 -0
  424. package/lib/plugins/runtime.js +451 -0
  425. package/lib/plugins/sandbox.d.ts +2 -0
  426. package/lib/plugins/sandbox.js +761 -0
  427. package/lib/plugins/schedule.d.ts +26 -0
  428. package/lib/plugins/schedule.js +538 -0
  429. package/lib/plugins/self-improve.d.ts +61 -0
  430. package/lib/plugins/self-improve.js +953 -0
  431. package/lib/plugins/session-search.d.ts +16 -0
  432. package/lib/plugins/session-search.js +308 -0
  433. package/lib/plugins/session-title.d.ts +19 -0
  434. package/lib/plugins/session-title.js +109 -0
  435. package/lib/plugins/session.d.ts +7 -0
  436. package/lib/plugins/session.js +296 -0
  437. package/lib/plugins/settings.d.ts +3 -0
  438. package/lib/plugins/settings.js +705 -0
  439. package/lib/plugins/skills.d.ts +2 -0
  440. package/lib/plugins/skills.js +360 -0
  441. package/lib/plugins/spill.d.ts +16 -0
  442. package/lib/plugins/spill.js +200 -0
  443. package/lib/plugins/subagent.d.ts +2 -0
  444. package/lib/plugins/subagent.js +862 -0
  445. package/lib/plugins/surfaces.d.ts +11 -0
  446. package/lib/plugins/surfaces.js +20 -0
  447. package/lib/plugins/team.d.ts +16 -0
  448. package/lib/plugins/team.js +149 -0
  449. package/lib/plugins/todo.d.ts +19 -0
  450. package/lib/plugins/todo.js +188 -0
  451. package/lib/plugins/tool-search.d.ts +2 -0
  452. package/lib/plugins/tool-search.js +425 -0
  453. package/lib/plugins/tools-default.d.ts +12 -0
  454. package/lib/plugins/tools-default.js +275 -0
  455. package/lib/plugins/tools.d.ts +16 -0
  456. package/lib/plugins/tools.js +62 -0
  457. package/lib/plugins/transcript.d.ts +15 -0
  458. package/lib/plugins/transcript.js +311 -0
  459. package/lib/plugins/tui.d.ts +2 -0
  460. package/lib/plugins/tui.js +98 -0
  461. package/lib/plugins/waiting.d.ts +12 -0
  462. package/lib/plugins/waiting.js +34 -0
  463. package/lib/plugins/web-search.d.ts +14 -0
  464. package/lib/plugins/web-search.js +263 -0
  465. package/lib/plugins/webserver.d.ts +48 -0
  466. package/lib/plugins/webserver.js +228 -0
  467. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  468. package/lib/remote/assets/icon-192.png +0 -0
  469. package/lib/remote/assets/icon-512.png +0 -0
  470. package/lib/remote/assets/index.html +34 -0
  471. package/lib/remote/assets/manifest.json +27 -0
  472. package/lib/remote/assets/style-DIB6729x.css +1 -0
  473. package/lib/remote/assets/sw.js +66 -0
  474. package/lib/services/types.d.ts +1228 -0
  475. package/lib/services/types.js +1 -0
  476. package/lib/tools/config-cli.d.ts +1 -0
  477. package/lib/tools/config-cli.js +89 -0
  478. package/lib/ui/arrival.d.ts +72 -0
  479. package/lib/ui/arrival.js +105 -0
  480. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  481. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  482. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  483. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  484. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  485. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  486. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  487. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  488. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  489. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  490. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  491. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  492. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  493. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  494. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  495. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  496. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  497. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  498. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  499. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  500. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  501. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  502. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  503. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  504. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  505. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  506. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  507. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  508. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  509. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  510. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  511. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  512. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  513. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  514. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  515. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  516. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  517. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  518. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  519. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  520. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  521. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  522. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  523. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  524. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  525. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  526. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  527. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  528. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  529. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  530. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  531. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  532. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  533. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  534. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  535. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  536. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  537. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  538. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  539. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  540. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  541. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  542. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  543. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  544. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  545. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  546. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  547. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  548. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  549. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  550. package/lib/ui/assets/icon.png +0 -0
  551. package/lib/ui/assets/index.html +14 -0
  552. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  553. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  554. package/lib/ui/frames.d.ts +67 -0
  555. package/lib/ui/frames.js +146 -0
  556. package/lib/ui/index.d.ts +59 -0
  557. package/lib/ui/index.js +50 -0
  558. package/lib/ui/manifest.d.ts +172 -0
  559. package/lib/ui/manifest.js +158 -0
  560. package/lib/ui/plugin.d.ts +161 -0
  561. package/lib/ui/plugin.js +7 -0
  562. package/lib/ui/plugins/browser/client.js +290 -0
  563. package/lib/ui/plugins/browser/icon.png +0 -0
  564. package/lib/ui/plugins/composer/client.js +1843 -0
  565. package/lib/ui/plugins/composer/icon.png +0 -0
  566. package/lib/ui/plugins/files/client.js +646 -0
  567. package/lib/ui/plugins/files/icon.png +0 -0
  568. package/lib/ui/plugins/manifest.json +107 -0
  569. package/lib/ui/plugins/plugins/client.js +682 -0
  570. package/lib/ui/plugins/plugins/icon.png +0 -0
  571. package/lib/ui/plugins/preview/client.js +197 -0
  572. package/lib/ui/plugins/preview/icon.png +0 -0
  573. package/lib/ui/plugins/prompt/client.js +653 -0
  574. package/lib/ui/plugins/prompt/icon.png +0 -0
  575. package/lib/ui/plugins/sessions/client.js +1577 -0
  576. package/lib/ui/plugins/sessions/icon.png +0 -0
  577. package/lib/ui/plugins/settings/client.js +5470 -0
  578. package/lib/ui/plugins/settings/icon.png +0 -0
  579. package/lib/ui/plugins/skills/client.js +485 -0
  580. package/lib/ui/plugins/skills/icon.png +0 -0
  581. package/lib/ui/plugins/status/client.js +1420 -0
  582. package/lib/ui/plugins/status/icon.png +0 -0
  583. package/lib/ui/plugins/statusbar/client.js +504 -0
  584. package/lib/ui/plugins/statusbar/icon.png +0 -0
  585. package/lib/ui/plugins/tasks/client.js +52 -0
  586. package/lib/ui/plugins/tasks/icon.png +0 -0
  587. package/lib/ui/plugins/team/client.js +527 -0
  588. package/lib/ui/plugins/team/icon.png +0 -0
  589. package/lib/ui/plugins/terminal/client.js +232 -0
  590. package/lib/ui/plugins/terminal/icon.png +0 -0
  591. package/lib/ui/plugins/trace/client.js +1376 -0
  592. package/lib/ui/plugins/trace/icon.png +0 -0
  593. package/lib/ui/plugins/transcript/client.js +2661 -0
  594. package/lib/ui/plugins/transcript/icon.png +0 -0
  595. package/lib/ui/scoped-slots.d.ts +20 -0
  596. package/lib/ui/scoped-slots.js +21 -0
  597. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  598. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  599. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  600. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  601. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  602. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  603. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  604. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  605. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  606. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  607. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  608. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  609. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  610. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  611. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  612. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  613. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  614. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  615. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  616. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  617. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  618. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  619. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  620. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  621. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  622. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  623. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  624. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  625. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  626. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  627. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  629. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  630. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  631. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  632. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  633. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  634. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  635. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  636. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  637. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  638. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  639. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  640. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  641. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  642. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  643. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  644. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  645. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  646. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  647. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  648. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  649. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  650. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  651. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  652. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  653. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  663. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  664. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  665. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  666. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  667. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  668. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  669. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  670. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  671. package/lib/ui/services-react.d.ts +27 -0
  672. package/lib/ui/services-react.js +32 -0
  673. package/lib/ui/services.d.ts +63 -0
  674. package/lib/ui/services.js +121 -0
  675. package/lib/ui/slots-ink.d.ts +26 -0
  676. package/lib/ui/slots-ink.js +78 -0
  677. package/lib/ui/slots-react.d.ts +28 -0
  678. package/lib/ui/slots-react.js +88 -0
  679. package/lib/ui/slots.d.ts +481 -0
  680. package/lib/ui/slots.js +550 -0
  681. package/lib/ui/store.d.ts +89 -0
  682. package/lib/ui/store.js +62 -0
  683. package/lib/ui/tui-plugin-api.d.ts +23 -0
  684. package/lib/ui/tui-plugin-api.js +23 -0
  685. package/lib/ui/tui-plugins.d.ts +47 -0
  686. package/lib/ui/tui-plugins.js +220 -0
  687. package/package.json +58 -6
@@ -0,0 +1,36 @@
1
+ /**
2
+ * UI ⇄ adapter 的共享契约(单一真源)。
3
+ *
4
+ * 边界规则(对齐 dsh-TUI 的 adapter 边界实践):
5
+ * - `src/adapter/**` 是唯一允许 import `@deepseek-ai/*` 运行期包的层;
6
+ * - UI 层(src/app/**、src/state/**、src/commands.ts)只依赖本文件的
7
+ * 中立类型,通过 DscRuntime 与宿主世界交互;
8
+ * - 本文件自身不得 import 任何 @deepseek-ai/*。
9
+ */
10
+ /** 状态栏段显隐的出厂默认(口径见 {@link StatusBarPrefsView})。 */
11
+ export const DEFAULT_STATUS_BAR_PREFS = {
12
+ model: true,
13
+ effort: false,
14
+ cache: true,
15
+ tokens: false,
16
+ cost: true,
17
+ mode: false,
18
+ policy: true,
19
+ ctx: true,
20
+ cwd: true,
21
+ session: false,
22
+ };
23
+ /**
24
+ * 把老存档 / 老宿主 / 手改坏档里的 `ui.statusBar` 归一成全键视图:对象缺失或
25
+ * 单键缺失都回落出厂默认(与 prefs.ts 的读档白名单同一口径,坏档不拦启动)。
26
+ * 桌面渲染层与 TUI 共用这一份——prefs.ts 带着 node 内置模块,渲染层 import 不得。
27
+ */
28
+ export function normalizeStatusBarPrefs(value) {
29
+ const source = typeof value === 'object' && value !== null ? value : {};
30
+ const merged = { ...DEFAULT_STATUS_BAR_PREFS };
31
+ for (const key of Object.keys(DEFAULT_STATUS_BAR_PREFS)) {
32
+ if (typeof source[key] === 'boolean')
33
+ merged[key] = source[key];
34
+ }
35
+ return merged;
36
+ }
@@ -0,0 +1,52 @@
1
+ import type { EffortLevel } from '../contract.js';
2
+ /** 角色文件目录。 */
3
+ export declare const DSC_AGENTS_DIR: string;
4
+ /** 队友想不想向用户要工具授权(最终还要受全局设置这个上限压着)。 */
5
+ export type TeammateApproval = 'forbid' | 'ask' | 'foreground';
6
+ /** 一个角色(含它被授权的范围,即「工牌」)。 */
7
+ export interface AgentRole {
8
+ /** 角色文件名(`<名字>.md`)。 */
9
+ file: string;
10
+ name: string;
11
+ description: string;
12
+ /** 工具白名单;null = 不限工具(仍受权限模式与审批上限约束)。 */
13
+ tools: string[] | null;
14
+ /** 模型覆盖,形状 `端点名/模型名`;null = 跟随当前模型。 */
15
+ model: string | null;
16
+ /** 思考强度覆盖;null = 跟随当前档位。 */
17
+ effort: EffortLevel | null;
18
+ /** 内部请求轮次上限(到点自动收手,防止子智能体无限自转)。 */
19
+ maxTurns: number;
20
+ /** 这个角色想不想弹审批卡。 */
21
+ approval: TeammateApproval;
22
+ enabled: boolean;
23
+ /** 正文 = 这个角色的系统提示词。 */
24
+ prompt: string;
25
+ /** 是不是 dsc 出厂自带的那几个角色。 */
26
+ builtin: boolean;
27
+ /** 文件里有问题时的说明(其余字段退回默认值)。 */
28
+ problem?: string;
29
+ }
30
+ /** 出厂角色名(UI 上标「内置」,删除时给提示但不阻止)。 */
31
+ export declare function builtinRoleNames(): string[];
32
+ /**
33
+ * 把还不存在的出厂角色写进角色目录。
34
+ * @returns 实际新写出的角色名(已存在的一律不覆盖)。
35
+ */
36
+ export declare function ensureBuiltinRoles(): string[];
37
+ /** 读一个角色文件;返回 null = 文件名不合法或读不起来。 */
38
+ export declare function readRole(file: string): AgentRole | null;
39
+ /**
40
+ * 取一个出厂角色的定义,**不落盘**(文件被用户删掉时 /review 仍要能派出审查员)。
41
+ * 只认 {@link BUILTIN_FILES} 里登记过的名字;其余返回 null。
42
+ */
43
+ export declare function builtinRole(name: string): AgentRole | null;
44
+ /** 列出全部角色,按名字排序;坏文件也列出来(带 problem),免得用户以为文件没生效。 */
45
+ export declare function listRoles(): AgentRole[];
46
+ /** 按名字取启用中的角色;不存在或未启用时返回 null。 */
47
+ export declare function findRole(name: string): AgentRole | null;
48
+ /** 写一个角色文件(设置界面「新建角色」用)。名字非法时抛错。 */
49
+ export declare function writeRole(name: string, patch: {
50
+ description: string;
51
+ prompt: string;
52
+ }): string;
@@ -0,0 +1,274 @@
1
+ /**
2
+ * 角色名册:一个角色就是 `~/.dsc/agents/<名字>.md` 一个文件。
3
+ * frontmatter 说清「这个队友被授权干什么」,正文就是这个队友的系统提示词——
4
+ * 形状和技能中心的 SKILL.md 一样,所以会写技能就会写角色。
5
+ *
6
+ * frontmatter 认这些键(都可选,缺省取下面的默认值):
7
+ *
8
+ * ```markdown
9
+ * ---
10
+ * name: explorer
11
+ * description: 只读探索:读代码、找定义、把事实汇总回来
12
+ * tools: read, glob, grep # 工具白名单;写 none 表示一个工具都不给
13
+ * model: # 例 deepseek/deepseek-chat;留空 = 跟随当前模型
14
+ * effort: default # default|off|low|high|max
15
+ * max-turns: 12 # 内部请求轮次上限,到点自动收手
16
+ * approval: forbid # forbid|ask|foreground:这个角色想不想弹审批卡
17
+ * enabled: true
18
+ * ---
19
+ * 这里是这个队友的系统提示词。
20
+ * ```
21
+ *
22
+ * 「工牌」= 从这里读出来的那份约束(工具白名单 + 审批意愿 + 轮次预算 + 模型)。
23
+ * 队友开工那一刻把工牌复制进运行时并冻结,之后改文件只影响下一个新队友。
24
+ *
25
+ * @module dsc/core/agent-roles
26
+ */
27
+ import { existsSync, mkdirSync, readFileSync, readdirSync, writeFileSync } from 'node:fs';
28
+ import { basename, join } from 'node:path';
29
+ import YAML from 'yaml';
30
+ import { splitFrontmatter } from './skills.js';
31
+ import { dscPath } from './path-policy.js';
32
+ /** 角色文件目录。 */
33
+ export const DSC_AGENTS_DIR = dscPath('agents');
34
+ const APPROVAL_MODES = ['forbid', 'ask', 'foreground'];
35
+ const EFFORTS = ['default', 'off', 'low', 'high', 'max'];
36
+ /** 角色名形状:小写字母数字加连字符,最长 32,够 UI 一排显示。 */
37
+ const ROLE_NAME = /^[a-z0-9][a-z0-9-]{0,31}$/;
38
+ /** 出厂角色:名字 → 文件内容。第一次用到时才写出去,之后用户随便改。 */
39
+ const BUILTIN_FILES = {
40
+ explorer: `---
41
+ name: explorer
42
+ description: 只读探索:读代码、找定义、把事实汇总回来
43
+ tools: read, glob, grep
44
+ max-turns: 12
45
+ approval: forbid
46
+ ---
47
+
48
+ 你是团队里的探索手。你只有读类工具,不能改文件也不能执行命令。
49
+
50
+ 工作方式:
51
+ 1. 先把任务拆成两三个具体要查的问题,别一上来就通读整个仓库。
52
+ 2. 用 glob/grep 定位,再用 read 精读关键片段;引结论时给出「文件名:行号」。
53
+ 3. 结论用一小段话交回来:查了什么、看到什么、结论是什么、哪里还没查清。
54
+ 4. 你没权限做的事不要反复尝试,直接写在回复里,让 Lead 或用户去决定。
55
+ `,
56
+ writer: `---
57
+ name: writer
58
+ description: 落地实现:按明确范围改代码、补测试
59
+ tools: read, write, edit, glob, grep, bash
60
+ max-turns: 20
61
+ approval: ask
62
+ ---
63
+
64
+ 你是团队里的实现手,负责把明确的需求落成代码。
65
+
66
+ 工作方式:
67
+ 1. 动手前先用一两句话说清你要改哪几个文件、为什么。
68
+ 2. 一次只推进一件事,改完立刻自检(类型检查或跑相关测试),失败就修。
69
+ 3. 严格按分配给你的写作用域改,超出范围的文件不要碰,写在回复里让 Lead 协调。
70
+ 4. 最后交一份改动清单:改了哪些文件、为什么这么改、还剩什么没做。
71
+ `,
72
+ critic: `---
73
+ name: critic
74
+ description: 反驳式审查:只读材料,专门找漏洞和反例
75
+ tools: read, glob, grep
76
+ max-turns: 4
77
+ approval: forbid
78
+ ---
79
+
80
+ 你是团队里的审查手,任务是推翻眼前这个方案,而不是夸它。
81
+
82
+ 工作方式:
83
+ 1. 先列出这个方案成立的隐含假设,逐条问「如果不成立会怎样」。
84
+ 2. 找反例:现有代码里有没有与之冲突的地方、边界条件、失败路径、并发与时序问题。
85
+ 3. 每条问题给出证据(文件名:行号)与严重程度;没有发现问题就明说你查过哪里。
86
+ 4. 不要提出完整替代方案,指出方向即可,方案由 Lead 定。
87
+ `,
88
+ reviewer: `---
89
+ name: reviewer
90
+ description: 代码审查(/review 用):只读过 diff 与相关代码,按固定格式交 findings
91
+ tools: read, glob, grep
92
+ max-turns: 16
93
+ approval: forbid
94
+ ---
95
+
96
+ 你是团队里的代码审查员。你会收到一份工作区未提交改动的 diff 和可选的关注点,用 read/glob/grep 打开相关文件核对上下文,然后交审查结论。
97
+
98
+ 分级口径:P1 = 正确性或安全问题,必须修;P2 = 边界、健壮性、性能问题,应该修;P3 = 可读性、风格、更好的写法,可以更好。
99
+
100
+ 每条 finding 严格按这个格式交(渲染层按它解析成卡片,一个字段都不能少):
101
+
102
+ ### [P1] 一句话标题
103
+ 位置:相对路径:行号
104
+ 说明:问题是什么、证据是什么(引用改动里的代码或 read 到的上下文)。
105
+ 建议:怎么改。
106
+
107
+ 规则:
108
+ 1. 位置用仓库相对路径与真实行号;整篇新增的文件写到关键行的行号。
109
+ 2. 先说结论——每个问题都要落到改动本身,不评审 diff 之外的历史遗留。
110
+ 3. 没有问题就只写一段话:明说没有发现问题,交代你查过的文件与维度。
111
+ 4. 你只有读类工具;跑不了构建和测试,判断依据是代码与 diff 本身,不确定的点在说明里如实标注。
112
+ `,
113
+ };
114
+ /** 出厂角色名(UI 上标「内置」,删除时给提示但不阻止)。 */
115
+ export function builtinRoleNames() {
116
+ return Object.keys(BUILTIN_FILES).sort();
117
+ }
118
+ /**
119
+ * 把还不存在的出厂角色写进角色目录。
120
+ * @returns 实际新写出的角色名(已存在的一律不覆盖)。
121
+ */
122
+ export function ensureBuiltinRoles() {
123
+ const created = [];
124
+ for (const [name, text] of Object.entries(BUILTIN_FILES)) {
125
+ const file = join(DSC_AGENTS_DIR, `${name}.md`);
126
+ if (existsSync(file))
127
+ continue;
128
+ try {
129
+ mkdirSync(DSC_AGENTS_DIR, { recursive: true });
130
+ writeFileSync(file, text, 'utf8');
131
+ created.push(name);
132
+ }
133
+ catch {
134
+ // 目录建不出来(只读盘、权限):不报错,让用户自己建文件。
135
+ }
136
+ }
137
+ return created;
138
+ }
139
+ /** 读一个角色文件;返回 null = 文件名不合法或读不起来。 */
140
+ export function readRole(file) {
141
+ const base = basename(file, '.md');
142
+ let text;
143
+ try {
144
+ text = readFileSync(file, 'utf8');
145
+ }
146
+ catch {
147
+ return null;
148
+ }
149
+ return parseRoleText(file, text);
150
+ }
151
+ /**
152
+ * 取一个出厂角色的定义,**不落盘**(文件被用户删掉时 /review 仍要能派出审查员)。
153
+ * 只认 {@link BUILTIN_FILES} 里登记过的名字;其余返回 null。
154
+ */
155
+ export function builtinRole(name) {
156
+ const text = BUILTIN_FILES[name];
157
+ if (text === undefined)
158
+ return null;
159
+ return parseRoleText(join(DSC_AGENTS_DIR, `${name}.md`), text);
160
+ }
161
+ /** 角色文本 → {@link AgentRole}(frontmatter 解析与缺省回退都在这;文件与内存构造共用)。 */
162
+ function parseRoleText(file, text) {
163
+ const base = basename(file, '.md');
164
+ const { front, body } = splitFrontmatter(text);
165
+ let doc = {};
166
+ let problem;
167
+ if (front.trim() !== '') {
168
+ try {
169
+ doc = YAML.parse(front) ?? {};
170
+ }
171
+ catch (error) {
172
+ problem = `frontmatter 不是合法 YAML:${error instanceof Error ? error.message : String(error)}`;
173
+ }
174
+ }
175
+ const declared = typeof doc.name === 'string' ? doc.name.trim() : '';
176
+ const name = declared !== '' ? declared : base;
177
+ if (!ROLE_NAME.test(name)) {
178
+ return {
179
+ file,
180
+ name: base,
181
+ description: '',
182
+ tools: null,
183
+ model: null,
184
+ effort: null,
185
+ maxTurns: 0,
186
+ approval: 'forbid',
187
+ enabled: false,
188
+ prompt: '',
189
+ builtin: base in BUILTIN_FILES,
190
+ problem: `角色名「${name}」不合法:只能用小写字母、数字、连字符,且不能以连字符开头`,
191
+ };
192
+ }
193
+ // tools: 逗号分隔字符串或 YAML 数组;none/空数组 = 一个工具都不给(null = 不限)
194
+ let tools = null;
195
+ const rawTools = doc.tools;
196
+ if (rawTools !== undefined) {
197
+ const items = Array.isArray(rawTools)
198
+ ? rawTools.map((item) => String(item))
199
+ : String(rawTools).split(/[,,\s]+/);
200
+ const list = items.map((item) => item.trim()).filter((item) => item !== '');
201
+ tools = list.length === 0 || list.every((item) => item === 'none') ? [] : list;
202
+ }
203
+ const rawModel = typeof doc.model === 'string' ? doc.model.trim() : '';
204
+ const rawEffort = typeof doc.effort === 'string' ? doc.effort.trim() : '';
205
+ let effort = null;
206
+ if (rawEffort !== '' && rawEffort !== 'default') {
207
+ if (EFFORTS.includes(rawEffort))
208
+ effort = rawEffort;
209
+ else
210
+ problem = problem ?? `effort 只能是 ${EFFORTS.join(' / ')},收到 ${rawEffort},本项退回跟随当前`;
211
+ }
212
+ const rawTurns = Number.parseInt(String(doc['max-turns'] ?? doc.maxTurns ?? ''), 10);
213
+ const maxTurns = Number.isFinite(rawTurns) ? Math.min(Math.max(rawTurns, 1), 200) : 12;
214
+ const rawApproval = typeof doc.approval === 'string' ? doc.approval.trim() : '';
215
+ let approval = 'forbid';
216
+ if (rawApproval !== '') {
217
+ if (APPROVAL_MODES.includes(rawApproval))
218
+ approval = rawApproval;
219
+ else
220
+ problem = problem ?? `approval 只能是 ${APPROVAL_MODES.join(' / ')},收到 ${rawApproval},本项退回 forbid`;
221
+ }
222
+ return {
223
+ file,
224
+ name,
225
+ description: typeof doc.description === 'string' ? doc.description.trim() : '',
226
+ tools,
227
+ model: rawModel !== '' ? rawModel : null,
228
+ effort,
229
+ maxTurns,
230
+ approval,
231
+ enabled: doc.enabled !== false && doc.enabled !== 'false',
232
+ prompt: body.trim(),
233
+ builtin: base in BUILTIN_FILES,
234
+ ...(problem !== undefined ? { problem } : {}),
235
+ };
236
+ }
237
+ /** 列出全部角色,按名字排序;坏文件也列出来(带 problem),免得用户以为文件没生效。 */
238
+ export function listRoles() {
239
+ if (!existsSync(DSC_AGENTS_DIR))
240
+ return [];
241
+ const out = [];
242
+ for (const entry of readdirSync(DSC_AGENTS_DIR)) {
243
+ if (!entry.endsWith('.md'))
244
+ continue;
245
+ const role = readRole(join(DSC_AGENTS_DIR, entry));
246
+ if (role !== null)
247
+ out.push(role);
248
+ }
249
+ return out.sort((a, b) => a.name.localeCompare(b.name));
250
+ }
251
+ /** 按名字取启用中的角色;不存在或未启用时返回 null。 */
252
+ export function findRole(name) {
253
+ if (!ROLE_NAME.test(name))
254
+ return null;
255
+ const role = readRole(join(DSC_AGENTS_DIR, `${name}.md`));
256
+ return role !== null && role.name === name && role.enabled ? role : null;
257
+ }
258
+ /** 写一个角色文件(设置界面「新建角色」用)。名字非法时抛错。 */
259
+ export function writeRole(name, patch) {
260
+ if (!ROLE_NAME.test(name)) {
261
+ throw new Error(`角色名「${name}」不合法:只能用小写字母、数字、连字符,且不能以连字符开头`);
262
+ }
263
+ mkdirSync(DSC_AGENTS_DIR, { recursive: true });
264
+ const file = join(DSC_AGENTS_DIR, `${name}.md`);
265
+ const text = `---
266
+ name: ${name}
267
+ description: ${patch.description}
268
+ ---
269
+
270
+ ${patch.prompt.trim() === '' ? `你是团队里的「${name}」。把这一段改成这个角色的具体职责和做事步骤。` : patch.prompt.trim()}
271
+ `;
272
+ writeFileSync(file, text, 'utf8');
273
+ return file;
274
+ }
@@ -0,0 +1,183 @@
1
+ import { type PrefixRule } from './command-policy.js';
2
+ import type { ToolGuard } from './tool-guards.js';
3
+ /** 配置键:插件条目树里的 file,同时是设置分区 id。 */
4
+ export declare const FLOOR_CONFIG_KEY = "approval-floor";
5
+ /** 可调值的合法区间(配置校验与设置页共用一份,两处不会写岔)。 */
6
+ export declare const FLOOR_LIMITS: {
7
+ readonly maxCommandLength: {
8
+ readonly min: 100;
9
+ readonly max: 100000;
10
+ };
11
+ readonly circuitBreakerThreshold: {
12
+ readonly min: 1;
13
+ readonly max: 100;
14
+ };
15
+ readonly circuitBreakerCooldownMs: {
16
+ readonly min: 0;
17
+ readonly max: 3600000;
18
+ };
19
+ };
20
+ /** 生效的地板配置。字段全部来自 Config,判定逻辑里没有可调值。 */
21
+ export interface FloorConfig {
22
+ /** 白名单前缀:每条是按序匹配的命令词,`*` 只许出现在末尾。 */
23
+ allowPrefixes: readonly (readonly string[])[];
24
+ /** deny 黑名单 glob,匹配命令原文、命令词元与写目标路径(不区分大小写)。 */
25
+ denyGlobs: readonly string[];
26
+ /** 命令最长字符数,更长的按「看不清要跑什么」拒。 */
27
+ maxCommandLength: number;
28
+ /** 连续被地板拒多少次后熔断。 */
29
+ circuitBreakerThreshold: number;
30
+ /** 熔断后冷却多久(毫秒)。 */
31
+ circuitBreakerCooldownMs: number;
32
+ /** 是否启用熔断。 */
33
+ circuitBreakerEnabled: boolean;
34
+ /** 无人值守:ask 级命令与工作区外的写一律拒。
35
+ * 这是个显式开关而不是自动探测——dsc 没有可靠的宿主交互信号(桌面端的 `process.stdin.isTTY` 会误判)。 */
36
+ unattended: boolean;
37
+ }
38
+ /** 读一次配置的结果。`problems` 非空时守卫一律拒,见 {@link createApprovalFloor}。 */
39
+ export interface FloorConfigResult {
40
+ config: FloorConfig;
41
+ /** 配置里读不通的地方(中文,会原样进 `/floor` 与那条启动提示)。 */
42
+ problems: string[];
43
+ }
44
+ /** 用户没写过的字段用这里的值。 */
45
+ export declare const DEFAULT_FLOOR_CONFIG: FloorConfig;
46
+ /** 一条前缀的解析结果。 */
47
+ export type PrefixParse = {
48
+ ok: true;
49
+ pattern: string[];
50
+ } | {
51
+ ok: false;
52
+ error: string;
53
+ };
54
+ /** 一条 glob 的解析结果。 */
55
+ export type GlobParse = {
56
+ ok: true;
57
+ glob: string;
58
+ } | {
59
+ ok: false;
60
+ error: string;
61
+ };
62
+ /** 一份前缀清单的解析结果。 */
63
+ export type ListParse = {
64
+ ok: true;
65
+ values: string[];
66
+ } | {
67
+ ok: false;
68
+ error: string;
69
+ };
70
+ /**
71
+ * 把设置页里的一行字解析成白名单前缀。
72
+ *
73
+ * @param text - 一行前缀,例如 `pnpm run build` 或 `git diff *`。
74
+ * @returns 解析好的词元数组,或一句说明哪里不能用。
75
+ */
76
+ export declare function parsePrefixEntry(text: string): PrefixParse;
77
+ /**
78
+ * 检查一条 deny glob 能不能用。
79
+ *
80
+ * @param text - 一行 glob,例如 `*etc/passwd*`。
81
+ * @returns 去掉首尾空白后的 glob,或一句说明哪里不能用。
82
+ */
83
+ export declare function parseGlobEntry(text: string): GlobParse;
84
+ /** 把设置页那个文本框切成一条条规则:换行或逗号分隔,空行丢掉。 */
85
+ export declare function splitListText(text: string): string[];
86
+ /**
87
+ * 解析设置页里的一整份前缀清单。
88
+ * @param text - 多行文本(换行或逗号分隔)。
89
+ * @returns 规范化后的前缀清单,或第一处错误。
90
+ */
91
+ export declare function parsePrefixListText(text: string): ListParse;
92
+ /**
93
+ * 解析设置页里的一整份 deny 黑名单。
94
+ * @param text - 多行文本(换行或逗号分隔)。
95
+ * @returns 规范化后的 glob 清单,或第一处错误。
96
+ */
97
+ export declare function parseGlobListText(text: string): ListParse;
98
+ /**
99
+ * 把一份原始配置(`resolvePluginConfig` 的返回值)解析成生效配置。
100
+ *
101
+ * 坏值一律回落到默认值并把原因写进 `problems`;调用方据此一律拒,
102
+ * 绝不静默采用半份配置——地板的配置读错了就是 fail-open。
103
+ *
104
+ * @param raw - 原始配置对象,可以是任何东西(磁盘上的东西不受类型系统保证)。
105
+ * @returns 生效配置与配置问题清单。
106
+ */
107
+ export declare function resolveFloorConfig(raw: unknown): FloorConfigResult;
108
+ /** 是哪一层给出的结论(诊断与自检按它对号入座)。 */
109
+ export type FloorLayer =
110
+ /** 配置读不通,按最严处理。 */
111
+ 'config'
112
+ /** 熔断冷却中。 */
113
+ | 'circuit'
114
+ /** 结构不可验证:引号括号、超长命令、编码执行、`sh -c`、命令替换。 */
115
+ | 'opaque'
116
+ /** 灾难地板:fork 炸弹、关机重启、硬地板规则。 */
117
+ | 'disaster'
118
+ /** 用户 deny 黑名单或 deny 前缀规则。 */
119
+ | 'deny-list'
120
+ /** 内置危险模式,交给审批问人。 */
121
+ | 'dangerous'
122
+ /** 无人值守:ask 级命令与工作区外的写。 */
123
+ | 'unattended'
124
+ /** 命中白名单,不弹卡。 */
125
+ | 'allowlist'
126
+ /** 地板没意见。 */
127
+ | 'none';
128
+ /** 一次判定的完整结论(比守卫裁决多带一层与一句理由,便于审计与 `/floor`)。 */
129
+ export type FloorOutcome = {
130
+ action: 'deny';
131
+ layer: FloorLayer;
132
+ reason: string;
133
+ } | {
134
+ action: 'defer';
135
+ layer: FloorLayer;
136
+ reason: string;
137
+ };
138
+ /** 熔断状态(`/floor` 与自检读它)。 */
139
+ export interface BreakerState {
140
+ /** 目前连续被地板拒了几次。 */
141
+ consecutiveDenies: number;
142
+ /** 熔断解除的时间戳(毫秒);0 = 没在熔断。 */
143
+ openUntil: number;
144
+ /** 此刻是否处于熔断中。 */
145
+ tripped: boolean;
146
+ }
147
+ /** {@link createApprovalFloor} 的入参。 */
148
+ export interface ApprovalFloorOptions {
149
+ /** 每次判定现读配置:磁盘上的改动能立刻生效,坏配置由 `problems` 报出来。 */
150
+ readConfig: () => FloorConfigResult;
151
+ /** 当前生效的用户前缀规则(与审批读同一份,避免两处判定不一致)。 */
152
+ rules: () => readonly PrefixRule[];
153
+ /** 当前时间(自检可以把时钟说快一点)。 */
154
+ now?: () => number;
155
+ }
156
+ /** 灾难地板:一位守卫 + 它的熔断状态。 */
157
+ export interface ApprovalFloor {
158
+ /** 挂到守卫链上的那一位(order 5)。 */
159
+ readonly guard: ToolGuard;
160
+ /**
161
+ * 这条命令在不在白名单里(命中就返回那串词元)。
162
+ *
163
+ * 地板自己不放行、只交出结论:审批层拿它免掉审批卡,而排在两者之间的安全钩子照常被问到。
164
+ */
165
+ whitelist(command: string): readonly string[] | null;
166
+ /** 当前熔断状态。 */
167
+ breaker(): BreakerState;
168
+ /** 清掉连续拒绝计数与熔断(切会话或用户改完配置时用)。 */
169
+ reset(): void;
170
+ }
171
+ /**
172
+ * 组装灾难地板。
173
+ *
174
+ * 配置读不通时守卫照样挂载、却一律拒:挂载失败等于链上根本没有地板,
175
+ * 那是 fail-open——比「全部拒掉、让用户看见问题去改」危险得多。
176
+ *
177
+ * 熔断只统计地板自己的 deny:地板排在审批前面,看不到审批最终怎么裁,
178
+ * 所以「连续被拒」不是「用户连续拒绝」,只是「同一条路反复撞在同一个坑里」。
179
+ *
180
+ * @param options - 见 {@link ApprovalFloorOptions}。
181
+ * @returns 守卫与它的状态读写。
182
+ */
183
+ export declare function createApprovalFloor(options: ApprovalFloorOptions): ApprovalFloor;