@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
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 wanganqi
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
package/README.md CHANGED
@@ -1,3 +1,145 @@
1
- # Temporary Holding Version
1
+ # Pneuma — 独立终端 AI harness
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ **全自研**的终端 AI 编程助手:自写 ReAct loop + 会话落盘 + 工具栈 + 审批,UI 用 ink(React for CLI),另有 Electron 桌面端;插件装配基于开源 cordis 上下文内核。
4
+
5
+ ## 有什么
6
+
7
+ - **一颗内核,三种前端**:终端 TUI、Electron 桌面端(默认已是插件化界面壳)、**手机浏览器遥控页**——局域网扫码配对,人在外面也能批卡、看进度、发消息(PWA + Web Push + Webhook)。
8
+ - **模型自由**:多端点 / 多模型随意切;上下文窗口、思考档位、图片 / 视频模态逐模型配置并可就地实测。输入框底栏两颗 chip 直接换模型与思考强度。
9
+ - **智能体协作**:子智能体、智能体团队(并行队友 + 收件箱 + 汇报)、任务清单、计划交付、跨轮目标续跑。
10
+ - **长期记忆**:跨会话事实分「全局 / 用户偏好 / 工作区」三格,当轮生效,可评估、可整理。
11
+ - **插件化**:每个服务一个 cordis 插件;官方 17 个可开关插件(见下)+ 单文件 ESM 第三方插件;桌面界面壳本身也是插件架构(带 SDK)。
12
+ - **安全默认**:写 / 执行一律过审批卡(一次授权一次生效);沙箱策略围栏、危险命令灾难地板、权限三档 × 审阅者正交轴。
13
+ - **长会话省 token**:旧工具结果按轮微压缩、历史图片按预算卸载、压缩前回插读过的文件、端点侧显式缓存断点。
14
+
15
+ ## 安装
16
+
17
+ **桌面端**(自带运行时,无需装 Node):到 [Releases](https://github.com/waq05/pneuma/releases) 下载
18
+ 安装版 `pneuma-setup-x.y.z.exe`(可选安装目录)或免安装单文件 `pneuma-portable-x.y.z.exe`。
19
+
20
+ **CLI**(`numa` 命令,需要 Node.js ≥ 22.19):
21
+
22
+ ```sh
23
+ npm i -g @waq666/pneuma # 或免安装:npx @waq666/pneuma
24
+ numa # 独立启动(新会话)
25
+ ```
26
+
27
+ **从源码跑**:
28
+
29
+ ```sh
30
+ git clone https://github.com/waq05/pneuma
31
+ cd pneuma && pnpm install && pnpm build
32
+ npm i -g file:. # 全局 numa 命令指向本地构建
33
+ ```
34
+
35
+ `numa --resume` 恢复上次会话;`numa --resume <会话jsonl路径>` 恢复指定会话。
36
+
37
+ ## 交互
38
+
39
+ | 按键 / 命令 | 作用 |
40
+ | --- | --- |
41
+ | 直接输入 + Enter | 发送消息 |
42
+ | 输入 `/` 后 | 输入框上方弹出候选面板:命令阶段列命令,`/model ` 后列**可用模型**(↑↓ 选择、Tab 补全、Esc 关闭) |
43
+ | ↑ / ↓(空输入时) | 翻输入历史 |
44
+ | Ctrl+C | 一次:打断当前回合;2 秒内两次:退出 |
45
+ | Ctrl+T | 展开/折叠思考(reasoning) |
46
+ | `/new` | 新建会话 |
47
+ | `/resume` | 恢复历史会话(↑↓ 选择,Enter 确认,Esc 取消) |
48
+ | `/compact` | 手动压缩上下文(自动阈值:估算 tokens > 80% × 模型上下文窗口) |
49
+ | `/model [端点/]模型名` | 切换模型(下一次请求生效;候选来自配置里的全部 provider/model) |
50
+ | 桌面端 Ctrl+V / 拖文件 | 把图片贴进输入框,随这条消息一起发出(模型没勾「照片」会被拒绝,见 §配置) |
51
+ | 桌面端双击待发贴图 | 全屏预览大图(点任意处或 Esc 关闭);贴图在会话切换后各回各的,不会串到别的会话 |
52
+ | `/help` `/exit` | 帮助 / 退出 |
53
+
54
+ 面板打开时按 Enter 会采用当前选中项;命令名还支持**唯一前缀自动展开**(输入 `/ne` 按 Enter 即执行 `/new`)。
55
+
56
+ 工具授权卡出现时:`y` 允许一次,`n`(或 Esc)拒绝。卡只弹在发起它的那个会话里——后台会话的卡不串到当前视图,切回去(状态点会亮)再答。
57
+
58
+ ## 工具集(6 件)
59
+
60
+ `bash`(PowerShell)、`read`、`write`、`edit`(唯一匹配替换)、`glob`、`grep`。
61
+ 读类工具自动放行;**写/执行类必须过审批卡**(无持久授权,一次授权一次生效)。
62
+
63
+ ## 配置
64
+
65
+ Pneuma 只读**自己的**配置文件(`~/.dsc/`):
66
+
67
+ - **`~/.dsc/config.yaml`**(主配置):`default`(默认 provider/model)+ `providers`
68
+ (`displayName` / `baseURL` / `apiKeyEnv` / `models` 列表;可选 `api` 选线上协议适配器,
69
+ 缺省 `openai-compat` 风格的 `openai-completions`,装了提供别的协议的插件后可换)。
70
+ - **模型可选字段**(不写就用默认,设置界面「模型」分区每个模型一行可直接改):
71
+
72
+ ```yaml
73
+ models:
74
+ - id: hy3-a
75
+ contextWindow: 200000 # 上下文窗口(用于压缩阈值与侧栏显示)
76
+ maxTokens: 32000 # 单次输出上限
77
+ thinkingLevels: [off, low, max] # 这个模型支持哪几档思考(默认四档 off/low/high/max)
78
+ thinkingParam: reasoning-effort # 档位发哪个字段:thinking / reasoning-effort / none
79
+ effortMap: { low: minimal, max: ultra_max } # 各档发给端点的线上值(写 null = 不发字段)
80
+ modalities: [text, image] # 能收什么输入:text / image / video
81
+ ```
82
+
83
+ `thinkingParam` 默认 `thinking`(只有开关、无档位字段的协议),此时低/高/最大都发 `thinking: enabled`;
84
+ 网关按档位取值的(发 `reasoning_effort`)要显式写成 `reasoning-effort`,界面上的思考档位才会真的生效。
85
+ `modalities` 没写 `image` 的模型,界面上贴图会被直接拒绝。
86
+ - **key 来源顺序**:`apiKeyEnv` 指向的环境变量 → `~/.dsc/credentials.yaml`。代码绝不打印 key。
87
+ - **`~/.dsc/config.json`**(可选轻量覆盖):`{ "provider": "...", "model": "...", "temperature": 0.7 }`。
88
+
89
+ ```sh
90
+ numa config show # 查看当前生效的端点/模型/key 来源(不打印 key)
91
+ ```
92
+
93
+ - **会话落盘**:`~/.dsc/sessions/<cwd 压缩名>/<uuid>.jsonl`(append-only,重放恢复);
94
+ `~/.dsc/.last-session` 是 `--resume` 无参时的指针。
95
+
96
+ ## 架构
97
+
98
+ ```
99
+ bin/dsc.js 启动器(零依赖):--resume / config 子命令 → spawn node lib/boot.js
100
+ src/boot.ts 进程入口:读配置 → createKernel()(cordis 装配)→ 装 UI 插件
101
+ src/tools/config-cli.ts numa config 命令行工具
102
+ src/core/ 自研引擎(零 UI 依赖)
103
+ config.ts 读 ~/.dsc/config.yaml + key 来源链(env → 凭据文件)
104
+ llm.ts OpenAI chat-completions 流式客户端(SSE/reasoning/tool_calls/usage/重试)
105
+ session.ts JSONL 会话(append-only + 重放恢复)
106
+ loop.ts MiniAgent ReAct 循环(turn → stream → 审批 → 工具 → 定稿)
107
+ tools/ bash/read/write/edit/glob/grep 注册表
108
+ approval.ts 写/执行类挂起等 y/n
109
+ compact.ts 保头折尾摘要压缩
110
+ src/adapter/ core 事件 → 快照投影(transcript 折叠 + core-runtime)
111
+ src/contract.ts UI ⇄ 运行时 的中性契约(DscRuntime)
112
+ src/host/kernel.ts 内核装配顺序 + 三档插件清单(运行内核 / 官方可开关 / 自定义)
113
+ src/plugins/ 每个服务一个 cordis 插件(含官方可开关插件,见下文清单)
114
+ src/app/ ink UI(App/ChatView/Composer/ToolCard/ApprovalCard/SessionPicker/StatusBar)
115
+ desktop/ Electron 桌面端:主进程 + 独立运行时子进程;界面默认加载壳产物,可回退旧渲染层
116
+ ui-shell/ 桌面与手机共用的界面壳(插件化:布局 + 基元 + 官方界面插件;产物落 lib/ui/assets)
117
+ scripts/composer-test.mjs 候选面板/输入行的确定性测试(node scripts/composer-test.mjs,16 项断言)
118
+ ```
119
+
120
+ **模式(Agent 预设)**:一根独立的旋钮,决定模型是谁、手上有什么、被叮嘱了什么(提示词 + 工具目录)。出厂四个——标准 / 极简 / 创造 / PTC,自己加的模式就是 `~/.dsc/presets/<名字>.md` 一个文件,设置页可图形编辑,输入框下方那颗旋钮或 `/preset <名字>` 切换。模式**只做减法**(工具白名单取子集、提示段只能摘掉四段),任何模式都放宽不了安全。详见 [docs/presets.md](docs/presets.md)。
121
+
122
+ 官方可开关插件共 **17 个**(默认开:网页搜索、审批灾难地板、大输出溢出、会话全文检索、沙箱、文件更改预览;默认关:子智能体、智能体团队、电脑操作、生命周期钩子、MCP 客户端、工具渐进披露、定时任务、LSP 代码智能、浏览器自动化、侧栏浏览器控制、自我改进等),在插件中心里手动开关;长期记忆是默认开的内核插件。完整清单与各自干什么见 [docs/development.md](docs/development.md) 第 4 节。
123
+
124
+ ## 已知限制
125
+
126
+ - 沙箱是策略围栏(默认开的 sandbox 插件:可写根白名单、受保护路径、命令前缀策略、一次性升权),拦得住 Pneuma 自己发起的工具调用,**拦不住命令内部的任意写**——那要选容器后端;最终兜底仍是审批卡。
127
+ - 插件能加工具、命令、事件监听、设置分区和技能来源,但拿不到 DOM:界面扩展只接受可 JSON 序列化的控件声明。
128
+ - Windows 中文输入法可能拦截审批卡的 y/n 键(输入法切英文即可)。
129
+ - **电脑控制**(无障碍元素级点击 / 拖拽 / 截图)目前仅 Windows,且没接沙箱——动作按危险分级审计,最终仍过审批卡。
130
+ - 跨进程的路由状态(当前模型/思考强度)不落盘,重启宿主后回到配置默认值。
131
+
132
+ ## 插件开发
133
+
134
+ 外部插件 = 单个 ESM `.js` 文件放进 `~/.dsc/plugins/`,可注册工具、命令、监听事件,
135
+ 桌面端「插件」页可视化管理。完整 API 与开发规范见 **[docs/plugin-development.md](docs/plugin-development.md)**;可运行示例见 `examples/plugins/ping.js`。
136
+
137
+ ## 文档
138
+
139
+ | 文档 | 讲什么 |
140
+ | --- | --- |
141
+ | [docs/development.md](docs/development.md) | 开发手册:运行时结构、三条启动链路、进程间协议、`~/.dsc` 数据面、扩展点清单、自检与打包、代码约定、排错与关键数值 |
142
+ | [docs/development-log.md](docs/development-log.md) | 开发记录:各阶段引入了什么、决策台账、真 bug 台账、还欠什么 |
143
+ | [docs/plugin-development.md](docs/plugin-development.md) | 插件 API 与开发规范 |
144
+ | [docs/presets.md](docs/presets.md) | **模式(Agent 预设)**:模式文件怎么写、出厂四个各是什么、可去掉哪些提示段、四条硬规矩 |
145
+ | [docs/ui-design.md](docs/ui-design.md) | 界面开发规范:设计原则、令牌体系、原语层、布局与反馈、键盘与动效、主题引擎对照 |
package/bin/dsc.js ADDED
@@ -0,0 +1,91 @@
1
+ #!/usr/bin/env node
2
+ /**
3
+ * Pneuma(numa)— 独立 TUI harness 的瘦启动器(零依赖)。
4
+ *
5
+ * v2 起 numa 不再经过 dsh:本文件只做参数翻译,然后 spawn
6
+ * `node <本包>/lib/boot.js`(编译产物)。保持零 lib 依赖,全局
7
+ * `npm i -g file:D:\dsc` 得到的 numa 命令开箱即跑。
8
+ * (文件名沿用 dsc.js:bin 命令名由 package.json 的 bin 键决定,与文件名无关。)
9
+ *
10
+ * `--resume [path]` / `-c` / `--continue`:无 path 时恢复上次会话
11
+ * (~/.dsc/.last-session 指针),有 path 时恢复指定会话 jsonl;
12
+ * 通过环境变量 DSC_RESUME_SESSION 交给 boot('1' = 自动 / 路径 = 指定)。
13
+ */
14
+ import { spawn } from 'node:child_process'
15
+ import { readFileSync } from 'node:fs'
16
+ import { dirname, join, resolve } from 'node:path'
17
+ import { fileURLToPath } from 'node:url'
18
+
19
+ const PKG_ROOT = resolve(dirname(fileURLToPath(import.meta.url)), '..')
20
+ const BOOT = join(PKG_ROOT, 'lib', 'boot.js')
21
+
22
+ function fail(message) {
23
+ console.error(`[numa] ${message}`)
24
+ process.exit(1)
25
+ }
26
+
27
+ // ── 子命令:version / help ───────────────────────────────────────────────────
28
+ const first = process.argv[2]
29
+ if (first === '--version' || first === '-v') {
30
+ let version = 'unknown'
31
+ try {
32
+ version = JSON.parse(readFileSync(join(PKG_ROOT, 'package.json'), 'utf8')).version ?? version
33
+ } catch {}
34
+ console.log(`Pneuma numa ${version}`)
35
+ process.exit(0)
36
+ }
37
+ if (first === '--help' || first === '-h') {
38
+ console.log(
39
+ '用法:numa [选项] | numa config <子命令>\n' +
40
+ '\n' +
41
+ '选项:\n' +
42
+ ' --resume [path] 恢复上次会话,或恢复指定 jsonl 的会话\n' +
43
+ ' -c, --continue 同 --resume\n' +
44
+ '\n' +
45
+ '配置:\n' +
46
+ ' numa config migrate [--force] 从 dsh 迁移模型配置到 ~/.dsc/config.yaml\n' +
47
+ ' numa config show 显示当前生效的端点/模型/key 来源\n',
48
+ )
49
+ process.exit(0)
50
+ }
51
+
52
+ // ── 子命令:config(交给 lib/tools/config-cli.js) ───────────────────────────
53
+ if (first === 'config') {
54
+ const child = spawn(process.execPath, [join(PKG_ROOT, 'lib', 'tools', 'config-cli.js'), ...process.argv.slice(3)], {
55
+ stdio: 'inherit',
56
+ env: process.env,
57
+ })
58
+ child.on('error', (error) => fail(`启动失败:${error.message}`))
59
+ child.on('exit', (code) => process.exit(code ?? 0))
60
+ } else {
61
+ // ── 参数拦截:--resume 走环境变量,其余透传给 boot ─────────────────────────
62
+ const passthrough = []
63
+ const argv = process.argv.slice(2)
64
+ for (let i = 0; i < argv.length; i += 1) {
65
+ const arg = argv[i]
66
+ if (arg === '--resume' || arg === '-c' || arg === '--continue' || arg.startsWith('--resume=')) {
67
+ let target = arg.startsWith('--resume=') ? arg.slice('--resume='.length).trim() : ''
68
+ if (!target && arg === '--resume' && argv[i + 1] !== undefined && !argv[i + 1].startsWith('-')) {
69
+ target = argv[++i].trim()
70
+ }
71
+ process.env.DSC_RESUME_SESSION = target === '' ? '1' : target
72
+ } else {
73
+ passthrough.push(arg)
74
+ }
75
+ }
76
+
77
+ // ── 启动:node lib/boot.js ────────────────────────────────────────────────
78
+ const child = spawn(process.execPath, [BOOT, ...passthrough], {
79
+ stdio: 'inherit',
80
+ env: process.env,
81
+ })
82
+
83
+ child.on('error', (error) => fail(`启动失败:${error.message}`))
84
+ child.on('exit', (code, signal) => {
85
+ if (signal) {
86
+ process.kill(process.pid, signal)
87
+ return
88
+ }
89
+ process.exit(code ?? 0)
90
+ })
91
+ }
@@ -0,0 +1,40 @@
1
+ /**
2
+ * dsc headless 宿主的 CJS 兼容入口。
3
+ *
4
+ * Electron 的 utilityProcess.fork 只加载 CJS 主模块,而 dsc 的编译产物是
5
+ * ESM(package type: module)——本 shim 以动态 import 加载真正的 ESM 入口
6
+ * lib/headless.js。同时它必须在同步阶段注册一条 parentPort 空监听:
7
+ * utilityProcess 环境下保活进程(协议监听与装配在 ESM 侧完成)。
8
+ *
9
+ * 用法(桌面端):
10
+ * utilityProcess.fork(<dsc>/bin/headless.cjs, [], { cwd })
11
+ * 用法(终端手测,stdin/stdout JSONL):
12
+ * node <dsc>/bin/headless.cjs
13
+ */
14
+ /* eslint-disable @typescript-eslint/no-require-imports */
15
+ 'use strict'
16
+
17
+ const { pathToFileURL } = require('node:url')
18
+ const { join } = require('node:path')
19
+
20
+ const entry = pathToFileURL(join(__dirname, '..', 'lib', 'headless.js')).href
21
+
22
+ if (process.parentPort !== undefined) {
23
+ // utilityProcess:同步注册监听保活(真正的协议处理在 ESM 侧的 host-stdio 插件)
24
+ process.parentPort.on('message', () => {})
25
+ }
26
+
27
+ import(entry).catch((error) => {
28
+ const message = error instanceof Error ? error.stack ?? error.message : String(error)
29
+ if (process.parentPort !== undefined) {
30
+ process.parentPort.postMessage({
31
+ type: 'result',
32
+ id: 0,
33
+ ok: false,
34
+ error: `宿主加载失败:${message}`,
35
+ })
36
+ } else {
37
+ console.error('[dsc] headless 加载失败:', message)
38
+ }
39
+ process.exit(1)
40
+ })
@@ -0,0 +1,11 @@
1
+ import { type DscCoreConfig } from '../core/config.js';
2
+ import type { DscRuntime } from '../contract.js';
3
+ export interface CoreRuntimeOptions {
4
+ /** 启动即恢复的会话 jsonl 路径(bin 的 --resume 翻译产物);'auto' = last-session。 */
5
+ resumeSessionPath?: string | null;
6
+ cwd?: string;
7
+ /** 首次迁移提示(boot 传入;显示为启动 system 条目)。 */
8
+ migrationNote?: string | undefined;
9
+ }
10
+ /** 创建独立 harness 运行时。构造即发起初始会话 + 会话列表。 */
11
+ export declare function createCoreRuntime(config: DscCoreConfig, options?: CoreRuntimeOptions): DscRuntime;
@@ -0,0 +1,259 @@
1
+ /**
2
+ * DscRuntime 的自研核心实现(dsc v2):MiniAgent + Session + Transcript,
3
+ * 零 @deepseek-ai 依赖。契约(src/contract.ts)与 v1 完全一致,UI 零改动。
4
+ *
5
+ * @module dsc/adapter/core-runtime
6
+ */
7
+ import { randomUUID } from 'node:crypto';
8
+ import { join } from 'node:path';
9
+ import { compactSession, estimateTokens } from '../core/compact.js';
10
+ import { MiniAgent } from '../core/loop.js';
11
+ import { buildSystemPrompt } from '../core/prompt.js';
12
+ import { defaultTools } from '../core/tools/index.js';
13
+ import { Session, listSessions, loadLastSessionPath, saveLastSession, sessionsRoot, } from '../core/session.js';
14
+ import { Transcript } from './transcript.js';
15
+ const err = (error) => (error instanceof Error ? error.message : String(error));
16
+ /** 创建独立 harness 运行时。构造即发起初始会话 + 会话列表。 */
17
+ export function createCoreRuntime(config, options = {}) {
18
+ const cwd = options.cwd ?? process.cwd();
19
+ const transcript = new Transcript();
20
+ // ---- 路由状态(/model 可热切换,下一次请求生效) ----
21
+ let currentProvider = config.defaultProvider;
22
+ let currentModel = config.defaultModel;
23
+ const route = () => {
24
+ const provider = config.providers[currentProvider];
25
+ if (provider === undefined) {
26
+ throw new Error('没有可用的模型端点(检查 ~/.dsh/settings.yaml 的 llm-pi-ai 段与对应 API key 环境变量)');
27
+ }
28
+ return {
29
+ baseUrl: provider.baseUrl,
30
+ apiKey: provider.apiKey,
31
+ model: currentModel,
32
+ maxTokens: provider.models.find((model) => model.id === currentModel)?.maxTokens,
33
+ temperature: config.temperature,
34
+ };
35
+ };
36
+ // ---- 审批(挂起 Promise ↔ 审批卡 y/n) ----
37
+ let pending = null;
38
+ const approval = {
39
+ decide(request, signal) {
40
+ return new Promise((resolve) => {
41
+ const id = randomUUID();
42
+ pending = { view: { id, toolName: request.toolName, argsSummary: request.argsSummary }, resolve };
43
+ invalidate();
44
+ signal.addEventListener('abort', () => {
45
+ if (pending?.view.id !== id)
46
+ return;
47
+ pending = null;
48
+ invalidate();
49
+ resolve('reject');
50
+ }, { once: true });
51
+ });
52
+ },
53
+ };
54
+ // ---- 工具注册表(6 件套:bash/read/write/edit/glob/grep) ----
55
+ const tools = () => defaultTools;
56
+ // ---- 会话与 agent(初始会话同步确定:resume 失败则新建) ----
57
+ const emit = (event) => {
58
+ if (transcript.reduce(event))
59
+ invalidate();
60
+ };
61
+ /** 当前模型路由 + 自动压缩阈值(contextWindow 的 80%)。 */
62
+ const autoCompact = async () => {
63
+ const provider = config.providers[currentProvider];
64
+ const model = provider?.models.find((entry) => entry.id === currentModel);
65
+ const threshold = (model?.contextWindow ?? 128_000) * 0.8;
66
+ if (estimateTokens(session.messages) <= threshold)
67
+ return;
68
+ await compactSession(session, route(), new AbortController().signal);
69
+ transcript.system('上下文接近模型上限,已自动压缩历史');
70
+ };
71
+ let session;
72
+ const resume = options.resumeSessionPath ?? null;
73
+ const resumePath = resume === 'auto' ? loadLastSessionPath() : resume;
74
+ try {
75
+ session = resumePath !== null ? Session.load(resumePath) : Session.create(cwd);
76
+ }
77
+ catch (error) {
78
+ session = Session.create(cwd);
79
+ setTimeout(() => {
80
+ transcript.system(`恢复会话失败(${err(error)}),已开新会话`);
81
+ invalidate();
82
+ }, 0);
83
+ }
84
+ const agent = new MiniAgent({
85
+ route,
86
+ systemPrompt: () => buildSystemPrompt(cwd),
87
+ tools,
88
+ approval,
89
+ emit,
90
+ autoCompact,
91
+ }, session);
92
+ saveLastSession(session);
93
+ let sessions = [];
94
+ let sessionsLoading = false;
95
+ // ---- 快照缓存 ----
96
+ const listeners = new Set();
97
+ let snapshot = null;
98
+ const invalidate = () => {
99
+ snapshot = null;
100
+ for (const listener of [...listeners])
101
+ listener();
102
+ };
103
+ const getSnapshot = () => {
104
+ if (snapshot === null) {
105
+ const turnState = pending !== null
106
+ ? 'awaiting-approval'
107
+ : transcript.inTurn
108
+ ? transcript.working
109
+ ? 'working'
110
+ : 'thinking'
111
+ : 'idle';
112
+ snapshot = {
113
+ entries: [...transcript.entries, ...transcript.liveEntries()],
114
+ status: {
115
+ sessionId: session.meta.id,
116
+ model: currentModel,
117
+ effort: null,
118
+ turnState,
119
+ usage: transcript.usage,
120
+ },
121
+ pendingApproval: pending?.view ?? null,
122
+ sessions,
123
+ sessionsLoading,
124
+ };
125
+ }
126
+ return snapshot;
127
+ };
128
+ // ---- 会话开关 ----
129
+ let sessionChain = Promise.resolve();
130
+ const openSessionNow = async (filePath) => {
131
+ transcript.clear();
132
+ invalidate();
133
+ try {
134
+ const next = filePath === undefined ? Session.create(cwd) : Session.load(filePath);
135
+ agent.switchSession(next);
136
+ session = next;
137
+ saveLastSession(session);
138
+ transcript.system(filePath === undefined
139
+ ? `新会话 ${session.meta.id.slice(0, 8)}(模型 ${currentModel})`
140
+ : `已恢复会话 ${session.meta.id.slice(0, 8)}(历史不回显)`);
141
+ }
142
+ catch (error) {
143
+ transcript.system(`会话打开失败:${err(error)}`);
144
+ }
145
+ invalidate();
146
+ };
147
+ const openSession = (filePath) => {
148
+ sessionChain = sessionChain.then(() => openSessionNow(filePath));
149
+ return sessionChain;
150
+ };
151
+ const dispose = () => {
152
+ agent.cancel();
153
+ session.close();
154
+ if (pending !== null) {
155
+ pending.resolve('reject');
156
+ pending = null;
157
+ }
158
+ listeners.clear();
159
+ };
160
+ // ---- DscRuntime ----
161
+ const runtime = {
162
+ subscribe(listener) {
163
+ listeners.add(listener);
164
+ return () => listeners.delete(listener);
165
+ },
166
+ getSnapshot,
167
+ submit(text) {
168
+ agent.followup(text);
169
+ },
170
+ interrupt() {
171
+ agent.cancel();
172
+ },
173
+ openSession(filePath) {
174
+ return openSession(filePath);
175
+ },
176
+ async compact() {
177
+ try {
178
+ const outcome = await compactSession(session, route(), new AbortController().signal);
179
+ transcript.system(outcome === 'compacted' ? '上下文已压缩' : '历史不长,无需压缩');
180
+ }
181
+ catch (error) {
182
+ transcript.system(`压缩失败:${err(error)}`);
183
+ }
184
+ invalidate();
185
+ },
186
+ async setModel(model) {
187
+ const [providerPart, modelPart] = model.includes('/') ? model.split('/', 2) : [currentProvider, model];
188
+ const provider = config.providers[providerPart];
189
+ if (provider === undefined) {
190
+ transcript.system(`没有名为 ${providerPart} 的端点;可用:${Object.keys(config.providers).join('、') || '(无)'}`);
191
+ invalidate();
192
+ return;
193
+ }
194
+ if (!provider.models.some((entry) => entry.id === modelPart)) {
195
+ transcript.system(`端点 ${providerPart} 没有模型 ${modelPart};可用:${provider.models.map((entry) => entry.id).join('、')}`);
196
+ invalidate();
197
+ return;
198
+ }
199
+ currentProvider = providerPart;
200
+ currentModel = modelPart;
201
+ transcript.system(`模型切换为 ${currentProvider}/${currentModel}(下一次请求生效)`);
202
+ invalidate();
203
+ },
204
+ async setEffort(_effort) {
205
+ // OpenAI chat-completions 协议无 effort 字段;v2 移除该命令(UI 命令表同步)。
206
+ transcript.system('v2 暂不支持 effort 档位(协议不含该参数)');
207
+ invalidate();
208
+ },
209
+ listModels() {
210
+ const choices = [];
211
+ for (const provider of Object.values(config.providers)) {
212
+ for (const model of provider.models) {
213
+ choices.push({
214
+ value: `${provider.name}/${model.id}`,
215
+ provider: provider.name,
216
+ model: model.id,
217
+ description: `${provider.displayName} · ${Math.round(model.contextWindow / 1000)}k 上下文`,
218
+ });
219
+ }
220
+ }
221
+ return choices;
222
+ },
223
+ async refreshSessions() {
224
+ sessionsLoading = true;
225
+ invalidate();
226
+ try {
227
+ sessions = listSessions().map((meta) => ({ id: joinSessionPath(meta.cwd, meta.id), cwd: meta.cwd, createdAt: meta.createdAt }));
228
+ }
229
+ catch (error) {
230
+ transcript.system(`会话列表读取失败:${err(error)}`);
231
+ }
232
+ sessionsLoading = false;
233
+ invalidate();
234
+ },
235
+ answerApproval(answer) {
236
+ const current = pending;
237
+ if (current === null)
238
+ return;
239
+ pending = null;
240
+ invalidate();
241
+ current.resolve(answer === 'allow-once' ? 'allow-once' : 'reject');
242
+ },
243
+ exit() {
244
+ dispose();
245
+ process.exit(0);
246
+ },
247
+ dispose,
248
+ };
249
+ // ---- 启动:会话列表(初始会话已在上方同步建立) ----
250
+ void runtime.refreshSessions();
251
+ if (options.migrationNote !== undefined)
252
+ transcript.system(options.migrationNote);
253
+ transcript.system(`会话 ${session.meta.id.slice(0, 8)} · 模型 ${currentProvider}/${currentModel}`);
254
+ return runtime;
255
+ }
256
+ /** 会话 cwd → jsonl 路径(sessions 列表的 id 即文件路径)。 */
257
+ function joinSessionPath(cwd, id) {
258
+ return join(sessionsRoot(), cwd.replace(/[\\/:]+/g, '-'), `${id}.jsonl`);
259
+ }
@@ -0,0 +1,18 @@
1
+ /**
2
+ * 宿主访问的唯一边界层(类型面)。
3
+ *
4
+ * 边界规则:只有 `src/adapter/**` 允许 import '@deepseek-ai/*'(运行时值 import
5
+ * 也只出现在这里);UI 层(src/app/**、src/commands.ts)只消费 `../contract.js`
6
+ * 的中性类型。宿主升级时只需要改本目录。
7
+ *
8
+ * 解析说明:插件安装在 profile 目录里,bare 的 '@deepseek-ai/*' import 会被解析到
9
+ * dsh 宿主自带的同一份实现(单实例,已实测 import.meta.resolve);package.json
10
+ * 里的 optional peers 是便携性兜底。
11
+ *
12
+ * @module dsc-tui/adapter/host
13
+ */
14
+ export type { Context } from '@deepseek-ai/cordis';
15
+ export type { Agent, AgentHandle, AgentOptions, AgentStatus, AssistantStreamFrame, } from '@deepseek-ai/dsh-agent';
16
+ export type { Session, SessionEvent, SessionId, UserMessage } from '@deepseek-ai/dsh-session';
17
+ export type { SessionPersistenceSnapshot } from '@deepseek-ai/dsh-session-persistence';
18
+ export type { ApprovalOutcome } from '@deepseek-ai/dsh-user-approval';
@@ -0,0 +1,14 @@
1
+ /**
2
+ * 宿主访问的唯一边界层(类型面)。
3
+ *
4
+ * 边界规则:只有 `src/adapter/**` 允许 import '@deepseek-ai/*'(运行时值 import
5
+ * 也只出现在这里);UI 层(src/app/**、src/commands.ts)只消费 `../contract.js`
6
+ * 的中性类型。宿主升级时只需要改本目录。
7
+ *
8
+ * 解析说明:插件安装在 profile 目录里,bare 的 '@deepseek-ai/*' import 会被解析到
9
+ * dsh 宿主自带的同一份实现(单实例,已实测 import.meta.resolve);package.json
10
+ * 里的 optional peers 是便携性兜底。
11
+ *
12
+ * @module dsc-tui/adapter/host
13
+ */
14
+ export {};
@@ -0,0 +1,15 @@
1
+ import type { Context } from './host.js';
2
+ import type { DscRuntime } from '../contract.js';
3
+ /** 插件配置里 adapter 关心的字段(由 index.ts 透传,避免与 index 循环 import)。 */
4
+ export interface DscRuntimeConfig {
5
+ provider?: string | undefined;
6
+ model?: string | undefined;
7
+ /** 'off' | 'low' | 'high' | 'max'(deepseek adapter 档位);非法值忽略。 */
8
+ effort?: string | undefined;
9
+ resumeSessionId?: string | undefined;
10
+ }
11
+ /**
12
+ * 创建 TUI 运行时。构造即发起:打开初始会话 + 拉取会话列表(均异步落快照)。
13
+ * 监听全部经 `ctx.on`(fiber 作用域),插件卸载时自动退订。
14
+ */
15
+ export declare function createRuntime(ctx: Context, config: DscRuntimeConfig): DscRuntime;