@waq666/pneuma 0.0.0-stage → 0.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +206 -3
  3. package/bin/dsc.js +91 -0
  4. package/bin/headless.cjs +40 -0
  5. package/lib/adapter/core-runtime.d.ts +11 -0
  6. package/lib/adapter/core-runtime.js +259 -0
  7. package/lib/adapter/host.d.ts +18 -0
  8. package/lib/adapter/host.js +14 -0
  9. package/lib/adapter/runtime.d.ts +15 -0
  10. package/lib/adapter/runtime.js +290 -0
  11. package/lib/adapter/transcript.d.ts +184 -0
  12. package/lib/adapter/transcript.js +605 -0
  13. package/lib/app/AgentsOverlay.d.ts +18 -0
  14. package/lib/app/AgentsOverlay.js +63 -0
  15. package/lib/app/App.d.ts +15 -0
  16. package/lib/app/App.js +1650 -0
  17. package/lib/app/App.js.nv-backup +1650 -0
  18. package/lib/app/ApprovalCard.d.ts +12 -0
  19. package/lib/app/ApprovalCard.js +76 -0
  20. package/lib/app/AskCard.d.ts +20 -0
  21. package/lib/app/AskCard.js +45 -0
  22. package/lib/app/ChatView.d.ts +63 -0
  23. package/lib/app/ChatView.js +310 -0
  24. package/lib/app/Composer.d.ts +50 -0
  25. package/lib/app/Composer.js +282 -0
  26. package/lib/app/DiffBlock.d.ts +6 -0
  27. package/lib/app/DiffBlock.js +37 -0
  28. package/lib/app/MarkdownView.d.ts +6 -0
  29. package/lib/app/MarkdownView.js +99 -0
  30. package/lib/app/ModelPicker.d.ts +7 -0
  31. package/lib/app/ModelPicker.js +18 -0
  32. package/lib/app/PlanReviewCard.d.ts +13 -0
  33. package/lib/app/PlanReviewCard.js +54 -0
  34. package/lib/app/PresetPicker.d.ts +11 -0
  35. package/lib/app/PresetPicker.js +19 -0
  36. package/lib/app/PreviewOverlay.d.ts +14 -0
  37. package/lib/app/PreviewOverlay.js +22 -0
  38. package/lib/app/SessionPicker.d.ts +43 -0
  39. package/lib/app/SessionPicker.js +56 -0
  40. package/lib/app/SettingsOverlay.d.ts +32 -0
  41. package/lib/app/SettingsOverlay.js +157 -0
  42. package/lib/app/SkillsPicker.d.ts +7 -0
  43. package/lib/app/SkillsPicker.js +19 -0
  44. package/lib/app/StatusBar.d.ts +22 -0
  45. package/lib/app/StatusBar.js +201 -0
  46. package/lib/app/TaskStrips.d.ts +13 -0
  47. package/lib/app/TaskStrips.js +40 -0
  48. package/lib/app/TimelineRail.d.ts +22 -0
  49. package/lib/app/TimelineRail.js +160 -0
  50. package/lib/app/TimelineRail.js.negbak +98 -0
  51. package/lib/app/TimelineRail.js.nv-backup +160 -0
  52. package/lib/app/ToolCard.d.ts +11 -0
  53. package/lib/app/ToolCard.js +64 -0
  54. package/lib/app/ToolCard.js.nv-backup +64 -0
  55. package/lib/app/TranscriptOverlay.d.ts +27 -0
  56. package/lib/app/TranscriptOverlay.js +36 -0
  57. package/lib/app/TranscriptViewport.d.ts +78 -0
  58. package/lib/app/TranscriptViewport.js +218 -0
  59. package/lib/app/Welcome.d.ts +6 -0
  60. package/lib/app/Welcome.js +71 -0
  61. package/lib/app/attach.d.ts +16 -0
  62. package/lib/app/attach.js +58 -0
  63. package/lib/app/click.d.ts +40 -0
  64. package/lib/app/click.js +103 -0
  65. package/lib/app/clipboard-image.d.ts +11 -0
  66. package/lib/app/clipboard-image.js +66 -0
  67. package/lib/app/cursor.d.ts +4 -0
  68. package/lib/app/cursor.js +24 -0
  69. package/lib/app/hello.d.ts +11 -0
  70. package/lib/app/hello.js +8 -0
  71. package/lib/app/history-store.d.ts +4 -0
  72. package/lib/app/history-store.js +41 -0
  73. package/lib/app/image-blocks.d.ts +12 -0
  74. package/lib/app/image-blocks.js +125 -0
  75. package/lib/app/keymap.d.ts +56 -0
  76. package/lib/app/keymap.js +56 -0
  77. package/lib/app/markdown.d.ts +54 -0
  78. package/lib/app/markdown.js +189 -0
  79. package/lib/app/mouse.d.ts +33 -0
  80. package/lib/app/mouse.js +35 -0
  81. package/lib/app/pointer.d.ts +16 -0
  82. package/lib/app/pointer.js +60 -0
  83. package/lib/app/scroll-model.d.ts +240 -0
  84. package/lib/app/scroll-model.js +347 -0
  85. package/lib/app/settings-model.d.ts +69 -0
  86. package/lib/app/settings-model.js +114 -0
  87. package/lib/app/snapshot-subscribe.d.ts +34 -0
  88. package/lib/app/snapshot-subscribe.js +110 -0
  89. package/lib/app/theme.d.ts +194 -0
  90. package/lib/app/theme.js +186 -0
  91. package/lib/app/ticker.d.ts +7 -0
  92. package/lib/app/ticker.js +53 -0
  93. package/lib/boot.d.ts +1 -0
  94. package/lib/boot.js +34 -0
  95. package/lib/commands.d.ts +49 -0
  96. package/lib/commands.js +115 -0
  97. package/lib/contract.d.ts +1973 -0
  98. package/lib/contract.js +36 -0
  99. package/lib/core/agent-roles.d.ts +52 -0
  100. package/lib/core/agent-roles.js +274 -0
  101. package/lib/core/approval-floor.d.ts +183 -0
  102. package/lib/core/approval-floor.js +679 -0
  103. package/lib/core/approval.d.ts +42 -0
  104. package/lib/core/approval.js +8 -0
  105. package/lib/core/audit.d.ts +61 -0
  106. package/lib/core/audit.js +59 -0
  107. package/lib/core/boot-notices.d.ts +6 -0
  108. package/lib/core/boot-notices.js +61 -0
  109. package/lib/core/cdp/actions.d.ts +182 -0
  110. package/lib/core/cdp/actions.js +649 -0
  111. package/lib/core/cdp/launch.d.ts +192 -0
  112. package/lib/core/cdp/launch.js +491 -0
  113. package/lib/core/cdp/snapshot.d.ts +139 -0
  114. package/lib/core/cdp/snapshot.js +316 -0
  115. package/lib/core/cdp/transport.d.ts +160 -0
  116. package/lib/core/cdp/transport.js +359 -0
  117. package/lib/core/command-policy.d.ts +108 -0
  118. package/lib/core/command-policy.js +580 -0
  119. package/lib/core/commands-completion.d.ts +78 -0
  120. package/lib/core/commands-completion.js +167 -0
  121. package/lib/core/compact-anchors.d.ts +76 -0
  122. package/lib/core/compact-anchors.js +284 -0
  123. package/lib/core/compact.d.ts +110 -0
  124. package/lib/core/compact.js +210 -0
  125. package/lib/core/config-store.d.ts +38 -0
  126. package/lib/core/config-store.js +307 -0
  127. package/lib/core/config.d.ts +36 -0
  128. package/lib/core/config.js +124 -0
  129. package/lib/core/connection-test.d.ts +60 -0
  130. package/lib/core/connection-test.js +84 -0
  131. package/lib/core/desktop-control.d.ts +298 -0
  132. package/lib/core/desktop-control.js +1311 -0
  133. package/lib/core/diff-text.d.ts +74 -0
  134. package/lib/core/diff-text.js +257 -0
  135. package/lib/core/dock-browser.d.ts +137 -0
  136. package/lib/core/dock-browser.js +146 -0
  137. package/lib/core/dock-ops.d.ts +59 -0
  138. package/lib/core/dock-ops.js +104 -0
  139. package/lib/core/dock-session.d.ts +39 -0
  140. package/lib/core/dock-session.js +28 -0
  141. package/lib/core/dsh-compat/hook.d.ts +18 -0
  142. package/lib/core/dsh-compat/hook.js +52 -0
  143. package/lib/core/dsh-compat/resolve-hook.d.ts +5 -0
  144. package/lib/core/dsh-compat/resolve-hook.js +59 -0
  145. package/lib/core/dsh-compat/tools-facade.d.ts +47 -0
  146. package/lib/core/dsh-compat/tools-facade.js +108 -0
  147. package/lib/core/err-text.d.ts +13 -0
  148. package/lib/core/err-text.js +15 -0
  149. package/lib/core/events.d.ts +149 -0
  150. package/lib/core/events.js +1 -0
  151. package/lib/core/git-exec.d.ts +23 -0
  152. package/lib/core/git-exec.js +72 -0
  153. package/lib/core/git-info.d.ts +47 -0
  154. package/lib/core/git-info.js +157 -0
  155. package/lib/core/goal.d.ts +89 -0
  156. package/lib/core/goal.js +189 -0
  157. package/lib/core/hooks.d.ts +272 -0
  158. package/lib/core/hooks.js +818 -0
  159. package/lib/core/host-browser-link.d.ts +59 -0
  160. package/lib/core/host-browser-link.js +9 -0
  161. package/lib/core/host-methods.d.ts +25 -0
  162. package/lib/core/host-methods.js +103 -0
  163. package/lib/core/image-diet.d.ts +77 -0
  164. package/lib/core/image-diet.js +127 -0
  165. package/lib/core/learnings/ledger.d.ts +73 -0
  166. package/lib/core/learnings/ledger.js +273 -0
  167. package/lib/core/learnings/skill-write.d.ts +250 -0
  168. package/lib/core/learnings/skill-write.js +854 -0
  169. package/lib/core/learnings/store.d.ts +102 -0
  170. package/lib/core/learnings/store.js +266 -0
  171. package/lib/core/lifecycle-hooks.d.ts +189 -0
  172. package/lib/core/lifecycle-hooks.js +576 -0
  173. package/lib/core/llm.d.ts +283 -0
  174. package/lib/core/llm.js +565 -0
  175. package/lib/core/lockfile.d.ts +17 -0
  176. package/lib/core/lockfile.js +110 -0
  177. package/lib/core/loop.d.ts +185 -0
  178. package/lib/core/loop.js +587 -0
  179. package/lib/core/lsp/client.d.ts +189 -0
  180. package/lib/core/lsp/client.js +690 -0
  181. package/lib/core/lsp/framing.d.ts +84 -0
  182. package/lib/core/lsp/framing.js +181 -0
  183. package/lib/core/lsp/line-shift.d.ts +28 -0
  184. package/lib/core/lsp/line-shift.js +127 -0
  185. package/lib/core/lsp/manager.d.ts +93 -0
  186. package/lib/core/lsp/manager.js +418 -0
  187. package/lib/core/lsp/normalize.d.ts +32 -0
  188. package/lib/core/lsp/normalize.js +139 -0
  189. package/lib/core/lsp/servers.d.ts +106 -0
  190. package/lib/core/lsp/servers.js +352 -0
  191. package/lib/core/lsp/uri.d.ts +76 -0
  192. package/lib/core/lsp/uri.js +179 -0
  193. package/lib/core/market.d.ts +51 -0
  194. package/lib/core/market.js +358 -0
  195. package/lib/core/mcp.d.ts +201 -0
  196. package/lib/core/mcp.js +836 -0
  197. package/lib/core/memory-eval.d.ts +158 -0
  198. package/lib/core/memory-eval.js +215 -0
  199. package/lib/core/memory.d.ts +266 -0
  200. package/lib/core/memory.js +703 -0
  201. package/lib/core/mention.d.ts +57 -0
  202. package/lib/core/mention.js +129 -0
  203. package/lib/core/microcompact.d.ts +48 -0
  204. package/lib/core/microcompact.js +79 -0
  205. package/lib/core/migrate.d.ts +56 -0
  206. package/lib/core/migrate.js +134 -0
  207. package/lib/core/model-caps.d.ts +83 -0
  208. package/lib/core/model-caps.js +150 -0
  209. package/lib/core/model-discovery.d.ts +19 -0
  210. package/lib/core/model-discovery.js +69 -0
  211. package/lib/core/modes.d.ts +72 -0
  212. package/lib/core/modes.js +152 -0
  213. package/lib/core/native-bridge.d.ts +135 -0
  214. package/lib/core/native-bridge.js +563 -0
  215. package/lib/core/path-policy.d.ts +32 -0
  216. package/lib/core/path-policy.js +248 -0
  217. package/lib/core/permission-presets.d.ts +67 -0
  218. package/lib/core/permission-presets.js +75 -0
  219. package/lib/core/plugin-loader.d.ts +36 -0
  220. package/lib/core/plugin-loader.js +294 -0
  221. package/lib/core/plugin-registry.d.ts +113 -0
  222. package/lib/core/plugin-registry.js +256 -0
  223. package/lib/core/prefs.d.ts +82 -0
  224. package/lib/core/prefs.js +372 -0
  225. package/lib/core/presets.d.ts +80 -0
  226. package/lib/core/presets.js +373 -0
  227. package/lib/core/pricing.d.ts +90 -0
  228. package/lib/core/pricing.js +126 -0
  229. package/lib/core/prompt.d.ts +92 -0
  230. package/lib/core/prompt.js +339 -0
  231. package/lib/core/ptc.d.ts +66 -0
  232. package/lib/core/ptc.js +70 -0
  233. package/lib/core/remote/frames.d.ts +91 -0
  234. package/lib/core/remote/frames.js +174 -0
  235. package/lib/core/remote/notify.d.ts +54 -0
  236. package/lib/core/remote/notify.js +77 -0
  237. package/lib/core/remote/owner.d.ts +32 -0
  238. package/lib/core/remote/owner.js +75 -0
  239. package/lib/core/remote/pairing.d.ts +104 -0
  240. package/lib/core/remote/pairing.js +261 -0
  241. package/lib/core/remote/push.d.ts +80 -0
  242. package/lib/core/remote/push.js +222 -0
  243. package/lib/core/remote/store.d.ts +18 -0
  244. package/lib/core/remote/store.js +59 -0
  245. package/lib/core/remote/tickets.d.ts +20 -0
  246. package/lib/core/remote/tickets.js +49 -0
  247. package/lib/core/remote/uploads.d.ts +63 -0
  248. package/lib/core/remote/uploads.js +161 -0
  249. package/lib/core/request-attribution.d.ts +26 -0
  250. package/lib/core/request-attribution.js +86 -0
  251. package/lib/core/request-invariant.d.ts +61 -0
  252. package/lib/core/request-invariant.js +199 -0
  253. package/lib/core/sandbox/backends.d.ts +64 -0
  254. package/lib/core/sandbox/backends.js +194 -0
  255. package/lib/core/sandbox/execpolicy.d.ts +93 -0
  256. package/lib/core/sandbox/execpolicy.js +452 -0
  257. package/lib/core/sandbox/net-proxy.d.ts +31 -0
  258. package/lib/core/sandbox/net-proxy.js +162 -0
  259. package/lib/core/sandbox/policy.d.ts +211 -0
  260. package/lib/core/sandbox/policy.js +559 -0
  261. package/lib/core/sandbox/win/abi.d.ts +161 -0
  262. package/lib/core/sandbox/win/abi.js +169 -0
  263. package/lib/core/sandbox/win/account.d.ts +71 -0
  264. package/lib/core/sandbox/win/account.js +206 -0
  265. package/lib/core/sandbox/win/acl.d.ts +54 -0
  266. package/lib/core/sandbox/win/acl.js +339 -0
  267. package/lib/core/sandbox/win/backend.d.ts +61 -0
  268. package/lib/core/sandbox/win/backend.js +249 -0
  269. package/lib/core/sandbox/win/doctor.d.ts +24 -0
  270. package/lib/core/sandbox/win/doctor.js +272 -0
  271. package/lib/core/sandbox/win/ffi.d.ts +107 -0
  272. package/lib/core/sandbox/win/ffi.js +166 -0
  273. package/lib/core/sandbox/win/net-abi.d.ts +154 -0
  274. package/lib/core/sandbox/win/net-abi.js +316 -0
  275. package/lib/core/sandbox/win/runner-entry.d.ts +35 -0
  276. package/lib/core/sandbox/win/runner-entry.js +391 -0
  277. package/lib/core/sandbox/win/setup.d.ts +60 -0
  278. package/lib/core/sandbox/win/setup.js +986 -0
  279. package/lib/core/sandbox/win/token.d.ts +35 -0
  280. package/lib/core/sandbox/win/token.js +238 -0
  281. package/lib/core/sandbox/win/wfp.d.ts +41 -0
  282. package/lib/core/sandbox/win/wfp.js +200 -0
  283. package/lib/core/sandbox/win/workspace-sid.d.ts +9 -0
  284. package/lib/core/sandbox/win/workspace-sid.js +45 -0
  285. package/lib/core/schedule/rule.d.ts +184 -0
  286. package/lib/core/schedule/rule.js +745 -0
  287. package/lib/core/schedule/runner.d.ts +185 -0
  288. package/lib/core/schedule/runner.js +678 -0
  289. package/lib/core/schedule/store.d.ts +182 -0
  290. package/lib/core/schedule/store.js +455 -0
  291. package/lib/core/secrets.d.ts +41 -0
  292. package/lib/core/secrets.js +150 -0
  293. package/lib/core/session-export.d.ts +18 -0
  294. package/lib/core/session-export.js +73 -0
  295. package/lib/core/session-index.d.ts +159 -0
  296. package/lib/core/session-index.js +683 -0
  297. package/lib/core/session-meta.d.ts +41 -0
  298. package/lib/core/session-meta.js +97 -0
  299. package/lib/core/session.d.ts +356 -0
  300. package/lib/core/session.js +998 -0
  301. package/lib/core/skills.d.ts +60 -0
  302. package/lib/core/skills.js +171 -0
  303. package/lib/core/spill.d.ts +159 -0
  304. package/lib/core/spill.js +329 -0
  305. package/lib/core/surface-registry.d.ts +45 -0
  306. package/lib/core/surface-registry.js +67 -0
  307. package/lib/core/team-board.d.ts +95 -0
  308. package/lib/core/team-board.js +316 -0
  309. package/lib/core/throughput.d.ts +46 -0
  310. package/lib/core/throughput.js +40 -0
  311. package/lib/core/todo-reminder.d.ts +44 -0
  312. package/lib/core/todo-reminder.js +55 -0
  313. package/lib/core/todo.d.ts +81 -0
  314. package/lib/core/todo.js +222 -0
  315. package/lib/core/token-estimate.d.ts +55 -0
  316. package/lib/core/token-estimate.js +82 -0
  317. package/lib/core/tool-guards.d.ts +103 -0
  318. package/lib/core/tool-guards.js +77 -0
  319. package/lib/core/tool-search.d.ts +152 -0
  320. package/lib/core/tool-search.js +311 -0
  321. package/lib/core/tools/bash.d.ts +281 -0
  322. package/lib/core/tools/bash.js +871 -0
  323. package/lib/core/tools/command-runner.d.ts +84 -0
  324. package/lib/core/tools/command-runner.js +68 -0
  325. package/lib/core/tools/fs-tools.d.ts +23 -0
  326. package/lib/core/tools/fs-tools.js +247 -0
  327. package/lib/core/tools/index.d.ts +8 -0
  328. package/lib/core/tools/index.js +4 -0
  329. package/lib/core/tools/sandbox-args.d.ts +51 -0
  330. package/lib/core/tools/sandbox-args.js +90 -0
  331. package/lib/core/tools/search-tools.d.ts +3 -0
  332. package/lib/core/tools/search-tools.js +153 -0
  333. package/lib/core/tools.d.ts +96 -0
  334. package/lib/core/tools.js +53 -0
  335. package/lib/core/ui-boot-source.d.ts +71 -0
  336. package/lib/core/ui-boot-source.js +121 -0
  337. package/lib/core/ui-bundles.d.ts +249 -0
  338. package/lib/core/ui-bundles.js +830 -0
  339. package/lib/core/ui-combo.d.ts +49 -0
  340. package/lib/core/ui-combo.js +55 -0
  341. package/lib/core/ui-events.d.ts +81 -0
  342. package/lib/core/ui-events.js +364 -0
  343. package/lib/core/ui-hmr.d.ts +36 -0
  344. package/lib/core/ui-hmr.js +128 -0
  345. package/lib/core/ui-methods.d.ts +69 -0
  346. package/lib/core/ui-methods.js +341 -0
  347. package/lib/core/ui-route.d.ts +69 -0
  348. package/lib/core/ui-route.js +122 -0
  349. package/lib/core/ui-server.d.ts +75 -0
  350. package/lib/core/ui-server.js +369 -0
  351. package/lib/core/ui-trust.d.ts +47 -0
  352. package/lib/core/ui-trust.js +164 -0
  353. package/lib/core/untrusted.d.ts +30 -0
  354. package/lib/core/untrusted.js +48 -0
  355. package/lib/core/update-check.d.ts +81 -0
  356. package/lib/core/update-check.js +177 -0
  357. package/lib/core/usage-log.d.ts +82 -0
  358. package/lib/core/usage-log.js +306 -0
  359. package/lib/core/version.d.ts +1 -0
  360. package/lib/core/version.js +37 -0
  361. package/lib/core/web-http.d.ts +57 -0
  362. package/lib/core/web-http.js +137 -0
  363. package/lib/core/web-static.d.ts +31 -0
  364. package/lib/core/web-static.js +75 -0
  365. package/lib/headless.d.ts +1 -0
  366. package/lib/headless.js +31 -0
  367. package/lib/host/kernel.d.ts +33 -0
  368. package/lib/host/kernel.js +451 -0
  369. package/lib/index.d.ts +41 -0
  370. package/lib/index.js +35 -0
  371. package/lib/plugins/agent.d.ts +2 -0
  372. package/lib/plugins/agent.js +274 -0
  373. package/lib/plugins/approval-floor.d.ts +2 -0
  374. package/lib/plugins/approval-floor.js +223 -0
  375. package/lib/plugins/approval.d.ts +16 -0
  376. package/lib/plugins/approval.js +674 -0
  377. package/lib/plugins/ask.d.ts +2 -0
  378. package/lib/plugins/ask.js +245 -0
  379. package/lib/plugins/browser.d.ts +68 -0
  380. package/lib/plugins/browser.js +1341 -0
  381. package/lib/plugins/commands.d.ts +23 -0
  382. package/lib/plugins/commands.js +498 -0
  383. package/lib/plugins/compact.d.ts +21 -0
  384. package/lib/plugins/compact.js +274 -0
  385. package/lib/plugins/computer-use.d.ts +47 -0
  386. package/lib/plugins/computer-use.js +539 -0
  387. package/lib/plugins/desktop-dock.d.ts +2 -0
  388. package/lib/plugins/desktop-dock.js +626 -0
  389. package/lib/plugins/dock-browser.d.ts +34 -0
  390. package/lib/plugins/dock-browser.js +765 -0
  391. package/lib/plugins/dsh-compat.d.ts +25 -0
  392. package/lib/plugins/dsh-compat.js +37 -0
  393. package/lib/plugins/file-review.d.ts +108 -0
  394. package/lib/plugins/file-review.js +393 -0
  395. package/lib/plugins/git.d.ts +26 -0
  396. package/lib/plugins/git.js +132 -0
  397. package/lib/plugins/goal.d.ts +20 -0
  398. package/lib/plugins/goal.js +245 -0
  399. package/lib/plugins/guards.d.ts +14 -0
  400. package/lib/plugins/guards.js +18 -0
  401. package/lib/plugins/hooks.d.ts +19 -0
  402. package/lib/plugins/hooks.js +583 -0
  403. package/lib/plugins/host-stdio.d.ts +88 -0
  404. package/lib/plugins/host-stdio.js +317 -0
  405. package/lib/plugins/image-diet.d.ts +17 -0
  406. package/lib/plugins/image-diet.js +85 -0
  407. package/lib/plugins/lifecycle-hooks.d.ts +26 -0
  408. package/lib/plugins/lifecycle-hooks.js +338 -0
  409. package/lib/plugins/llm.d.ts +13 -0
  410. package/lib/plugins/llm.js +215 -0
  411. package/lib/plugins/lsp.d.ts +54 -0
  412. package/lib/plugins/lsp.js +608 -0
  413. package/lib/plugins/mcp.d.ts +16 -0
  414. package/lib/plugins/mcp.js +673 -0
  415. package/lib/plugins/memory.d.ts +17 -0
  416. package/lib/plugins/memory.js +858 -0
  417. package/lib/plugins/microcompact.d.ts +18 -0
  418. package/lib/plugins/microcompact.js +119 -0
  419. package/lib/plugins/mode.d.ts +18 -0
  420. package/lib/plugins/mode.js +115 -0
  421. package/lib/plugins/permission-presets.d.ts +18 -0
  422. package/lib/plugins/permission-presets.js +135 -0
  423. package/lib/plugins/plan.d.ts +2 -0
  424. package/lib/plugins/plan.js +192 -0
  425. package/lib/plugins/plugin-manager.d.ts +2 -0
  426. package/lib/plugins/plugin-manager.js +165 -0
  427. package/lib/plugins/presets.d.ts +2 -0
  428. package/lib/plugins/presets.js +182 -0
  429. package/lib/plugins/prompt.d.ts +2 -0
  430. package/lib/plugins/prompt.js +264 -0
  431. package/lib/plugins/ptc.d.ts +2 -0
  432. package/lib/plugins/ptc.js +272 -0
  433. package/lib/plugins/remote/http.d.ts +11 -0
  434. package/lib/plugins/remote/http.js +11 -0
  435. package/lib/plugins/remote/routes.d.ts +24 -0
  436. package/lib/plugins/remote/routes.js +384 -0
  437. package/lib/plugins/remote/types.d.ts +135 -0
  438. package/lib/plugins/remote/types.js +87 -0
  439. package/lib/plugins/remote.d.ts +17 -0
  440. package/lib/plugins/remote.js +1028 -0
  441. package/lib/plugins/runtime-api.d.ts +16 -0
  442. package/lib/plugins/runtime-api.js +99 -0
  443. package/lib/plugins/runtime.d.ts +10 -0
  444. package/lib/plugins/runtime.js +451 -0
  445. package/lib/plugins/sandbox.d.ts +2 -0
  446. package/lib/plugins/sandbox.js +761 -0
  447. package/lib/plugins/schedule.d.ts +26 -0
  448. package/lib/plugins/schedule.js +538 -0
  449. package/lib/plugins/self-improve.d.ts +61 -0
  450. package/lib/plugins/self-improve.js +953 -0
  451. package/lib/plugins/session-search.d.ts +16 -0
  452. package/lib/plugins/session-search.js +308 -0
  453. package/lib/plugins/session-title.d.ts +19 -0
  454. package/lib/plugins/session-title.js +109 -0
  455. package/lib/plugins/session.d.ts +7 -0
  456. package/lib/plugins/session.js +296 -0
  457. package/lib/plugins/settings.d.ts +3 -0
  458. package/lib/plugins/settings.js +705 -0
  459. package/lib/plugins/skills.d.ts +2 -0
  460. package/lib/plugins/skills.js +360 -0
  461. package/lib/plugins/spill.d.ts +16 -0
  462. package/lib/plugins/spill.js +200 -0
  463. package/lib/plugins/subagent.d.ts +2 -0
  464. package/lib/plugins/subagent.js +896 -0
  465. package/lib/plugins/surfaces.d.ts +11 -0
  466. package/lib/plugins/surfaces.js +20 -0
  467. package/lib/plugins/team.d.ts +16 -0
  468. package/lib/plugins/team.js +149 -0
  469. package/lib/plugins/todo.d.ts +19 -0
  470. package/lib/plugins/todo.js +188 -0
  471. package/lib/plugins/tool-search.d.ts +2 -0
  472. package/lib/plugins/tool-search.js +434 -0
  473. package/lib/plugins/tool-search.js.nv-backup +434 -0
  474. package/lib/plugins/tools-default.d.ts +12 -0
  475. package/lib/plugins/tools-default.js +275 -0
  476. package/lib/plugins/tools.d.ts +16 -0
  477. package/lib/plugins/tools.js +62 -0
  478. package/lib/plugins/transcript.d.ts +15 -0
  479. package/lib/plugins/transcript.js +311 -0
  480. package/lib/plugins/tui.d.ts +2 -0
  481. package/lib/plugins/tui.js +98 -0
  482. package/lib/plugins/waiting.d.ts +12 -0
  483. package/lib/plugins/waiting.js +34 -0
  484. package/lib/plugins/web-search.d.ts +14 -0
  485. package/lib/plugins/web-search.js +263 -0
  486. package/lib/plugins/webserver.d.ts +48 -0
  487. package/lib/plugins/webserver.js +228 -0
  488. package/lib/remote/assets/app-DAcUCOEn.js +14 -0
  489. package/lib/remote/assets/icon-192.png +0 -0
  490. package/lib/remote/assets/icon-512.png +0 -0
  491. package/lib/remote/assets/index.html +34 -0
  492. package/lib/remote/assets/manifest.json +27 -0
  493. package/lib/remote/assets/style-DIB6729x.css +1 -0
  494. package/lib/remote/assets/sw.js +66 -0
  495. package/lib/services/types.d.ts +1228 -0
  496. package/lib/services/types.js +1 -0
  497. package/lib/tools/config-cli.d.ts +1 -0
  498. package/lib/tools/config-cli.js +89 -0
  499. package/lib/ui/arrival.d.ts +72 -0
  500. package/lib/ui/arrival.js +105 -0
  501. package/lib/ui/assets/app-B70nVIKd.js +69 -0
  502. package/lib/ui/assets/chunk-2UxHyX5q.js +1 -0
  503. package/lib/ui/assets/chunk-B1dDrJ26.js +1 -0
  504. package/lib/ui/assets/chunk-B6aJPvgy.js +1 -0
  505. package/lib/ui/assets/chunk-BEwlwnbL.js +1 -0
  506. package/lib/ui/assets/chunk-BGcgwlCI.js +12 -0
  507. package/lib/ui/assets/chunk-BIGW1oBm.js +1 -0
  508. package/lib/ui/assets/chunk-BPQ3VLAy.js +1 -0
  509. package/lib/ui/assets/chunk-BRH0KZbk.js +141 -0
  510. package/lib/ui/assets/chunk-BX6H_ySx.js +1 -0
  511. package/lib/ui/assets/chunk-B_P3UbPa.js +1 -0
  512. package/lib/ui/assets/chunk-B_TYUkTI.js +1 -0
  513. package/lib/ui/assets/chunk-B_vNuMnf.js +1 -0
  514. package/lib/ui/assets/chunk-BajyYBss.js +10 -0
  515. package/lib/ui/assets/chunk-BdnUsdx6.js +1 -0
  516. package/lib/ui/assets/chunk-Buea-lGh.js +1 -0
  517. package/lib/ui/assets/chunk-C0PvZCCE.js +1 -0
  518. package/lib/ui/assets/chunk-C0m74zRD.js +1 -0
  519. package/lib/ui/assets/chunk-C27-OAKa.js +1 -0
  520. package/lib/ui/assets/chunk-C2oV4EkX.js +1 -0
  521. package/lib/ui/assets/chunk-C7zT0LnQ.js +1 -0
  522. package/lib/ui/assets/chunk-C9GSunVT.js +1 -0
  523. package/lib/ui/assets/chunk-C9tS-k6U.js +1 -0
  524. package/lib/ui/assets/chunk-CHLpvVh8.js +1 -0
  525. package/lib/ui/assets/chunk-CLxacb5B.js +1 -0
  526. package/lib/ui/assets/chunk-COt5Ahok.js +1 -0
  527. package/lib/ui/assets/chunk-CPTIWCL2.js +1 -0
  528. package/lib/ui/assets/chunk-CQLl-L-p.js +1 -0
  529. package/lib/ui/assets/chunk-CUWRgxuq.js +55 -0
  530. package/lib/ui/assets/chunk-CWanVSXC.js +1 -0
  531. package/lib/ui/assets/chunk-Cf5RLm7j.js +1 -0
  532. package/lib/ui/assets/chunk-CickPsom.js +1 -0
  533. package/lib/ui/assets/chunk-Cj5Yp3dK.js +1 -0
  534. package/lib/ui/assets/chunk-Cmh6b_Ma.js +1 -0
  535. package/lib/ui/assets/chunk-Cp-IABpG.js +1 -0
  536. package/lib/ui/assets/chunk-CqE71os6.js +1 -0
  537. package/lib/ui/assets/chunk-CtKP3W-j.js +1 -0
  538. package/lib/ui/assets/chunk-Cvjx9yec.js +1 -0
  539. package/lib/ui/assets/chunk-CxGP3dtY.js +1 -0
  540. package/lib/ui/assets/chunk-CylS5w8V.js +1 -0
  541. package/lib/ui/assets/chunk-D38fbIBN.js +1 -0
  542. package/lib/ui/assets/chunk-D97Zzqfu.js +1 -0
  543. package/lib/ui/assets/chunk-DAi9KRSo.js +1 -0
  544. package/lib/ui/assets/chunk-DHK4yRfg.js +1 -0
  545. package/lib/ui/assets/chunk-DJeabLx-.js +1 -0
  546. package/lib/ui/assets/chunk-DNRxmY5a.js +1 -0
  547. package/lib/ui/assets/chunk-DNSN1z5r.js +1 -0
  548. package/lib/ui/assets/chunk-DNasK_ZG.js +1 -0
  549. package/lib/ui/assets/chunk-DPvrY3IQ.js +1 -0
  550. package/lib/ui/assets/chunk-DXmwc3jG.js +1 -0
  551. package/lib/ui/assets/chunk-Dd0kTxKP.js +1 -0
  552. package/lib/ui/assets/chunk-De0Btta0.js +1 -0
  553. package/lib/ui/assets/chunk-Des-eS-w.js +1 -0
  554. package/lib/ui/assets/chunk-Df6bDoY_.js +1 -0
  555. package/lib/ui/assets/chunk-DijEV5ha.js +1 -0
  556. package/lib/ui/assets/chunk-DkvoVjww.js +1 -0
  557. package/lib/ui/assets/chunk-DlC-OlHO.js +1 -0
  558. package/lib/ui/assets/chunk-DnzrXTVv.js +1 -0
  559. package/lib/ui/assets/chunk-Dualf0xi.js +1 -0
  560. package/lib/ui/assets/chunk-EXT84bkm.js +1 -0
  561. package/lib/ui/assets/chunk-GwR3hkPK.js +1 -0
  562. package/lib/ui/assets/chunk-P80f7IUj.js +1 -0
  563. package/lib/ui/assets/chunk-VOosw3JB.js +1 -0
  564. package/lib/ui/assets/chunk-YQ4lDkt_.js +140 -0
  565. package/lib/ui/assets/chunk-Yzrsuije.js +1 -0
  566. package/lib/ui/assets/chunk-Z72CF80r.js +1 -0
  567. package/lib/ui/assets/chunk-g9-lgVsj.js +1 -0
  568. package/lib/ui/assets/chunk-vGWfd6FD.js +1 -0
  569. package/lib/ui/assets/chunk-wDzz0qaB.js +1 -0
  570. package/lib/ui/assets/chunk-ySF7HWmS.js +1 -0
  571. package/lib/ui/assets/icon.png +0 -0
  572. package/lib/ui/assets/index.html +14 -0
  573. package/lib/ui/assets/pdf.worker.min-CjEcRF4W.mjs +28 -0
  574. package/lib/ui/assets/style-Bq01xH_b.css +1 -0
  575. package/lib/ui/frames.d.ts +67 -0
  576. package/lib/ui/frames.js +146 -0
  577. package/lib/ui/index.d.ts +59 -0
  578. package/lib/ui/index.js +50 -0
  579. package/lib/ui/manifest.d.ts +172 -0
  580. package/lib/ui/manifest.js +158 -0
  581. package/lib/ui/plugin.d.ts +161 -0
  582. package/lib/ui/plugin.js +7 -0
  583. package/lib/ui/plugins/browser/client.js +290 -0
  584. package/lib/ui/plugins/browser/icon.png +0 -0
  585. package/lib/ui/plugins/composer/client.js +1843 -0
  586. package/lib/ui/plugins/composer/icon.png +0 -0
  587. package/lib/ui/plugins/files/client.js +646 -0
  588. package/lib/ui/plugins/files/icon.png +0 -0
  589. package/lib/ui/plugins/manifest.json +107 -0
  590. package/lib/ui/plugins/plugins/client.js +682 -0
  591. package/lib/ui/plugins/plugins/icon.png +0 -0
  592. package/lib/ui/plugins/preview/client.js +197 -0
  593. package/lib/ui/plugins/preview/icon.png +0 -0
  594. package/lib/ui/plugins/prompt/client.js +653 -0
  595. package/lib/ui/plugins/prompt/icon.png +0 -0
  596. package/lib/ui/plugins/sessions/client.js +1577 -0
  597. package/lib/ui/plugins/sessions/icon.png +0 -0
  598. package/lib/ui/plugins/settings/client.js +5470 -0
  599. package/lib/ui/plugins/settings/icon.png +0 -0
  600. package/lib/ui/plugins/skills/client.js +485 -0
  601. package/lib/ui/plugins/skills/icon.png +0 -0
  602. package/lib/ui/plugins/status/client.js +1420 -0
  603. package/lib/ui/plugins/status/icon.png +0 -0
  604. package/lib/ui/plugins/statusbar/client.js +504 -0
  605. package/lib/ui/plugins/statusbar/icon.png +0 -0
  606. package/lib/ui/plugins/tasks/client.js +52 -0
  607. package/lib/ui/plugins/tasks/icon.png +0 -0
  608. package/lib/ui/plugins/team/client.js +527 -0
  609. package/lib/ui/plugins/team/icon.png +0 -0
  610. package/lib/ui/plugins/terminal/client.js +232 -0
  611. package/lib/ui/plugins/terminal/icon.png +0 -0
  612. package/lib/ui/plugins/trace/client.js +1376 -0
  613. package/lib/ui/plugins/trace/icon.png +0 -0
  614. package/lib/ui/plugins/transcript/client.js +2661 -0
  615. package/lib/ui/plugins/transcript/icon.png +0 -0
  616. package/lib/ui/scoped-slots.d.ts +20 -0
  617. package/lib/ui/scoped-slots.js +21 -0
  618. package/lib/ui/sdk/@dsc/ui/index.d.ts +242 -0
  619. package/lib/ui/sdk/@dsc/ui/package.json +16 -0
  620. package/lib/ui/sdk/@dsc/ui-core/contract.d.ts +1973 -0
  621. package/lib/ui/sdk/@dsc/ui-core/core/diff-text.d.ts +74 -0
  622. package/lib/ui/sdk/@dsc/ui-core/core/dock-browser.d.ts +137 -0
  623. package/lib/ui/sdk/@dsc/ui-core/core/dock-ops.d.ts +59 -0
  624. package/lib/ui/sdk/@dsc/ui-core/core/model-caps.d.ts +83 -0
  625. package/lib/ui/sdk/@dsc/ui-core/core/native-bridge.d.ts +135 -0
  626. package/lib/ui/sdk/@dsc/ui-core/core/token-estimate.d.ts +55 -0
  627. package/lib/ui/sdk/@dsc/ui-core/package.json +16 -0
  628. package/lib/ui/sdk/@dsc/ui-core/ui/arrival.d.ts +72 -0
  629. package/lib/ui/sdk/@dsc/ui-core/ui/frames.d.ts +67 -0
  630. package/lib/ui/sdk/@dsc/ui-core/ui/index.d.ts +59 -0
  631. package/lib/ui/sdk/@dsc/ui-core/ui/manifest.d.ts +172 -0
  632. package/lib/ui/sdk/@dsc/ui-core/ui/plugin.d.ts +161 -0
  633. package/lib/ui/sdk/@dsc/ui-core/ui/scoped-slots.d.ts +20 -0
  634. package/lib/ui/sdk/@dsc/ui-core/ui/services-react.d.ts +27 -0
  635. package/lib/ui/sdk/@dsc/ui-core/ui/services.d.ts +63 -0
  636. package/lib/ui/sdk/@dsc/ui-core/ui/slots-react.d.ts +28 -0
  637. package/lib/ui/sdk/@dsc/ui-core/ui/slots.d.ts +481 -0
  638. package/lib/ui/sdk/@dsc/ui-core/ui/store.d.ts +89 -0
  639. package/lib/ui/sdk/@dsc/ui-dockkit/dock-model.d.ts +238 -0
  640. package/lib/ui/sdk/@dsc/ui-dockkit/dock-state.d.ts +163 -0
  641. package/lib/ui/sdk/@dsc/ui-dockkit/dock.d.ts +24 -0
  642. package/lib/ui/sdk/@dsc/ui-dockkit/index.d.ts +15 -0
  643. package/lib/ui/sdk/@dsc/ui-dockkit/package.json +16 -0
  644. package/lib/ui/sdk/@dsc/ui-layout/app.d.ts +74 -0
  645. package/lib/ui/sdk/@dsc/ui-layout/appearance.d.ts +70 -0
  646. package/lib/ui/sdk/@dsc/ui-layout/host-channel.d.ts +112 -0
  647. package/lib/ui/sdk/@dsc/ui-layout/index.d.ts +34 -0
  648. package/lib/ui/sdk/@dsc/ui-layout/package.json +16 -0
  649. package/lib/ui/sdk/@dsc/ui-layout/page-state.d.ts +14 -0
  650. package/lib/ui/sdk/@dsc/ui-layout/review-pane.d.ts +21 -0
  651. package/lib/ui/sdk/@dsc/ui-layout/runtime-context.d.ts +44 -0
  652. package/lib/ui/sdk/@dsc/ui-layout/thread-view.d.ts +28 -0
  653. package/lib/ui/sdk/@dsc/ui-layout/update-button.d.ts +21 -0
  654. package/lib/ui/sdk/@dsc/ui-primitives/code-file-icon-artwork.d.ts +53 -0
  655. package/lib/ui/sdk/@dsc/ui-primitives/code-view.d.ts +15 -0
  656. package/lib/ui/sdk/@dsc/ui-primitives/compat.d.ts +27 -0
  657. package/lib/ui/sdk/@dsc/ui-primitives/completion-sound.d.ts +24 -0
  658. package/lib/ui/sdk/@dsc/ui-primitives/confirm.d.ts +33 -0
  659. package/lib/ui/sdk/@dsc/ui-primitives/css.d.ts +47 -0
  660. package/lib/ui/sdk/@dsc/ui-primitives/diff-rows.d.ts +20 -0
  661. package/lib/ui/sdk/@dsc/ui-primitives/file-icons.d.ts +38 -0
  662. package/lib/ui/sdk/@dsc/ui-primitives/file-type-classify.d.ts +66 -0
  663. package/lib/ui/sdk/@dsc/ui-primitives/file-type-icon.d.ts +57 -0
  664. package/lib/ui/sdk/@dsc/ui-primitives/highlight.d.ts +24 -0
  665. package/lib/ui/sdk/@dsc/ui-primitives/hover-delay.d.ts +17 -0
  666. package/lib/ui/sdk/@dsc/ui-primitives/icons.d.ts +109 -0
  667. package/lib/ui/sdk/@dsc/ui-primitives/index.d.ts +55 -0
  668. package/lib/ui/sdk/@dsc/ui-primitives/lang-table.d.ts +10 -0
  669. package/lib/ui/sdk/@dsc/ui-primitives/markdown.d.ts +20 -0
  670. package/lib/ui/sdk/@dsc/ui-primitives/native.d.ts +41 -0
  671. package/lib/ui/sdk/@dsc/ui-primitives/package.json +16 -0
  672. package/lib/ui/sdk/@dsc/ui-primitives/panels.d.ts +86 -0
  673. package/lib/ui/sdk/@dsc/ui-primitives/paths.d.ts +11 -0
  674. package/lib/ui/sdk/@dsc/ui-primitives/pdf-view.d.ts +13 -0
  675. package/lib/ui/sdk/@dsc/ui-primitives/plugin-text.d.ts +15 -0
  676. package/lib/ui/sdk/@dsc/ui-primitives/select.d.ts +35 -0
  677. package/lib/ui/sdk/@dsc/ui-primitives/table-view.d.ts +23 -0
  678. package/lib/ui/sdk/@dsc/ui-primitives/thread-resizer.d.ts +22 -0
  679. package/lib/ui/sdk/@dsc/ui-primitives/time.d.ts +33 -0
  680. package/lib/ui/sdk/@dsc/ui-primitives/toast.d.ts +16 -0
  681. package/lib/ui/sdk/@dsc/ui-primitives/tokens.d.ts +14 -0
  682. package/lib/ui/sdk/@dsc/ui-primitives/tool-args.d.ts +49 -0
  683. package/lib/ui/sdk/@dsc/ui-primitives/tool-summary.d.ts +64 -0
  684. package/lib/ui/sdk/@dsc/ui-renderer/boot.d.ts +121 -0
  685. package/lib/ui/sdk/@dsc/ui-renderer/hmr.d.ts +43 -0
  686. package/lib/ui/sdk/@dsc/ui-renderer/index.d.ts +20 -0
  687. package/lib/ui/sdk/@dsc/ui-renderer/package.json +16 -0
  688. package/lib/ui/sdk/@dsc/ui-slots/index.d.ts +19 -0
  689. package/lib/ui/sdk/@dsc/ui-slots/package.json +16 -0
  690. package/lib/ui/sdk/@dsc/ui-slots/slots-react.d.ts +48 -0
  691. package/lib/ui/sdk/@dsc/ui-slots/slots.d.ts +102 -0
  692. package/lib/ui/services-react.d.ts +27 -0
  693. package/lib/ui/services-react.js +32 -0
  694. package/lib/ui/services.d.ts +63 -0
  695. package/lib/ui/services.js +121 -0
  696. package/lib/ui/slots-ink.d.ts +26 -0
  697. package/lib/ui/slots-ink.js +78 -0
  698. package/lib/ui/slots-react.d.ts +28 -0
  699. package/lib/ui/slots-react.js +88 -0
  700. package/lib/ui/slots.d.ts +481 -0
  701. package/lib/ui/slots.js +550 -0
  702. package/lib/ui/store.d.ts +89 -0
  703. package/lib/ui/store.js +62 -0
  704. package/lib/ui/tui-plugin-api.d.ts +23 -0
  705. package/lib/ui/tui-plugin-api.js +23 -0
  706. package/lib/ui/tui-plugins.d.ts +47 -0
  707. package/lib/ui/tui-plugins.js +220 -0
  708. package/package.json +58 -6
@@ -0,0 +1,182 @@
1
+ import { type ScheduleRule } from './rule.js';
2
+ /** 任务最近一次执行的结果。`never` = 从没跑过;`running` = 槽位已推进、投递还没落定。 */
3
+ export type ScheduleStatus = 'never' | 'running' | 'ok' | 'failed' | 'blocked' | 'skipped' | 'done';
4
+ /** 一条定时任务。这就是 tasks.json 里的一项,字段名改了老文件就读不回来。 */
5
+ export interface ScheduleTask {
6
+ id: string;
7
+ title: string;
8
+ /** 到点后交给模型的那段任务描述。 */
9
+ prompt: string;
10
+ rule: ScheduleRule;
11
+ /** 显式 IANA 时区(`daily:09:30` 这类墙上时刻靠它换算)。 */
12
+ timeZone: string;
13
+ enabled: boolean;
14
+ /** 下一次该跑的绝对时刻;null = 不再跑(一次性任务已经跑过)。 */
15
+ nextRunAt: number | null;
16
+ lastRunAt: number | null;
17
+ lastStatus: ScheduleStatus;
18
+ /** 最近一次失败 / 阻塞的原因原文,给用户看。 */
19
+ lastError: string | null;
20
+ /** 连续失败次数;「到过模型」就清零(见 runner 的失败重试阶梯)。 */
21
+ failureStreak: number;
22
+ /** 已经推进、但还没投递完的那个槽位(绝对时刻);null = 没有悬空的槽位。 */
23
+ pendingSlot: number | null;
24
+ /** 谁建的:`user`(命令/设置页)/ `model`(工具)/ `system`。 */
25
+ createdBy: string;
26
+ /** 最近的投递时刻(毫秒),按 30 天或 200 条裁剪。 */
27
+ deliveryHistory: number[];
28
+ /** 建任务时的会话 id(记录来源;投递只能投当前会话,见 runner 的说明)。 */
29
+ sessionId: string;
30
+ createdAt: number;
31
+ updatedAt: number;
32
+ }
33
+ /** 执行台账里的一条(runs.jsonl 的一行)。 */
34
+ export interface ScheduleRun {
35
+ /** 记账时刻(毫秒)。 */
36
+ at: number;
37
+ id: string;
38
+ title: string;
39
+ /** 这次对应哪个排期槽位(绝对时刻)。 */
40
+ slot: number;
41
+ /** ok / failed / blocked / skipped / recovered / manual。 */
42
+ status: string;
43
+ detail: string;
44
+ }
45
+ /** 台账默认保留条数。再多也没人看,还会把文件撑到几兆。 */
46
+ export declare const DEFAULT_RUN_LIMIT = 1000;
47
+ /** 投递历史默认保留条数。 */
48
+ export declare const DEFAULT_HISTORY_LIMIT = 200;
49
+ /** 投递历史默认保留天数。 */
50
+ export declare const DEFAULT_HISTORY_WINDOW_MS: number;
51
+ /** 存储层的可调项(测试时把 dir 指到临时目录)。 */
52
+ export interface ScheduleStoreOptions {
53
+ /** 数据目录;缺省 `~/.dsc/schedule`。 */
54
+ dir?: string;
55
+ /** 台账保留条数。 */
56
+ runLimit?: number;
57
+ /** 投递历史保留条数。 */
58
+ historyLimit?: number;
59
+ /** 投递历史保留时长。 */
60
+ historyWindowMs?: number;
61
+ /** 取当前时刻(测试注入用)。 */
62
+ now?: () => number;
63
+ }
64
+ /** 数据目录:`DSC_HOME` 优先(和仓库其他模块同一套约定),否则 `~/.dsc/schedule`。 */
65
+ export declare function scheduleDir(): string;
66
+ /** 读盘结果:任务清单 + 一句「文件有问题」的说明(没问题时为 null)。 */
67
+ export interface ScheduleLoadResult {
68
+ tasks: ScheduleTask[];
69
+ problem: string | null;
70
+ }
71
+ /**
72
+ * 把磁盘上的一项收敛成合法任务;认不出返回 null(调用方跳过并记账)。
73
+ * 磁盘文件是用户能手改的,属于不可信输入。
74
+ */
75
+ export declare function normalizeTask(value: unknown): ScheduleTask | null;
76
+ /** 建任务时要给的字段。 */
77
+ export interface ScheduleTaskInput {
78
+ title: string;
79
+ prompt: string;
80
+ rule: ScheduleRule;
81
+ timeZone: string;
82
+ createdBy?: string;
83
+ sessionId?: string;
84
+ enabled?: boolean;
85
+ }
86
+ /** 任务里可以被改的字段(其余字段只有 runner 会动)。 */
87
+ export interface ScheduleTaskPatch {
88
+ title?: string;
89
+ prompt?: string;
90
+ rule?: ScheduleRule;
91
+ timeZone?: string;
92
+ enabled?: boolean;
93
+ }
94
+ /** 一次投递结束后的记账。 */
95
+ export interface SlotOutcome {
96
+ status: ScheduleStatus;
97
+ error?: string | null;
98
+ /** 成功投递时记一条投递历史。 */
99
+ delivered?: boolean;
100
+ /** 投递之后 nextRunAt 要落在哪里;不传 = 不动(beginSlot 已经推过了)。 */
101
+ nextRunAt?: number | null;
102
+ /** 连续失败次数;不传 = 按 status 自己推。 */
103
+ failureStreak?: number;
104
+ }
105
+ export declare class ScheduleStore {
106
+ readonly dir: string;
107
+ readonly tasksFile: string;
108
+ readonly runsFile: string;
109
+ readonly lockFile: string;
110
+ private runLimit;
111
+ private historyLimit;
112
+ private readonly historyWindowMs;
113
+ private readonly clock;
114
+ private tasks;
115
+ private runLines;
116
+ /** 写操作串行链:上一个无论如何结束,下一个才开始。 */
117
+ private chain;
118
+ /** 最近一次读盘发现的问题,交给设置分区与命令显示。 */
119
+ private lastProblem;
120
+ constructor(options?: ScheduleStoreOptions);
121
+ /** 读盘时发现的问题(损坏兜底、跳过的坏条目)。 */
122
+ get problem(): string | null;
123
+ /**
124
+ * 改保留额度(设置分区里改了「历史保留条数」立刻生效,不必重启宿主)。
125
+ * @param limits - 台账条数与投递历史条数,都是 1 以上的整数
126
+ */
127
+ setLimits(limits: {
128
+ runLimit?: number;
129
+ historyLimit?: number;
130
+ }): void;
131
+ /** 从磁盘读一遍任务清单(同步;文件很小,属于启动与 tick 前的必备动作)。 */
132
+ load(): ScheduleLoadResult;
133
+ /** 重新读盘(tick 前调用:别的进程刚写的改动要能看见)。 */
134
+ reload(): ScheduleLoadResult;
135
+ /** 当前清单(复制出来的,改它不影响 store)。 */
136
+ list(): ScheduleTask[];
137
+ get(id: string): ScheduleTask | undefined;
138
+ /** 按 id 前缀找一条(命令里打 `a1b2` 比打全 id 顺手);命中多条返回 `ambiguous`。 */
139
+ findByPrefix(prefix: string): {
140
+ ok: true;
141
+ task: ScheduleTask;
142
+ } | {
143
+ ok: false;
144
+ error: string;
145
+ };
146
+ /** 新建一条任务并落盘。 */
147
+ create(input: ScheduleTaskInput): Promise<ScheduleTask>;
148
+ /** 改一条任务(标题 / 描述 / 规则 / 时区 / 启停);改了规则或时区就把排期清空让 runner 重算。 */
149
+ update(id: string, patch: ScheduleTaskPatch): Promise<ScheduleTask | null>;
150
+ /** 删一条任务;返回是否真的删掉了。 */
151
+ remove(id: string): Promise<boolean>;
152
+ /**
153
+ * 至多一次的第一步:把 `nextRunAt` 推到 `next`(null = 到此为止)、记下 `pendingSlot`,落盘。
154
+ * 这一步落盘之后才允许投递——崩在投递中途也不会在重启后重投(靠 pendingSlot 补一次)。
155
+ */
156
+ beginSlot(id: string, slot: number, next: number | null): Promise<ScheduleTask | null>;
157
+ /** 投递结束(成功、定性失败、被跳过都算)后清 `pendingSlot` 并记账。 */
158
+ endSlot(id: string, outcome: SlotOutcome): Promise<ScheduleTask | null>;
159
+ /** 只改排期(tick 里给没到点的任务补算 nextRunAt 用)。 */
160
+ setNextRunAt(id: string, next: number | null): Promise<ScheduleTask | null>;
161
+ /** 已经推进、还没投递完的任务(进程崩在投递中途的现场)。 */
162
+ pendingTasks(): ScheduleTask[];
163
+ /** 追加一条执行台账;超过上限就裁到最近 runLimit 条。 */
164
+ appendRun(run: ScheduleRun): Promise<void>;
165
+ /** 读最近若干条台账(新的在前)。文件不存在或整行坏掉都不抛错。 */
166
+ recentRuns(limit?: number): ScheduleRun[];
167
+ /** FIFO:把一次读-改-写挂到链尾。前一个失败不阻塞后一个。 */
168
+ private enqueue;
169
+ /** 整份重写 tasks.json(tmp + rename 原子替换)。 */
170
+ private persist;
171
+ private appendRunSync;
172
+ /** 数台账行数(数一次记下来;只有本进程会写它,因为有 .lock 互斥)。 */
173
+ private countRunLines;
174
+ /** 把台账裁到最近 runLimit 条(同样 tmp + rename)。 */
175
+ private compactRuns;
176
+ /** 投递历史:先按 30 天砍,再按 200 条砍。 */
177
+ private appendHistory;
178
+ /** 读盘 / 落盘时顺手裁一下历史(老文件里可能积了很多)。 */
179
+ private trimHistory;
180
+ }
181
+ /** 把 catch 到的东西变成一句话(`useUnknownInCatchVariables` 下不能直接当 Error 用)。 */
182
+ export declare function errorText(error: unknown): string;
@@ -0,0 +1,455 @@
1
+ /**
2
+ * 定时任务的落盘层:任务定义 `~/.dsc/schedule/tasks.json` + 执行台账 `~/.dsc/schedule/runs.jsonl`。
3
+ *
4
+ * 为什么这么设计:
5
+ * 1. **只写 `~/.dsc/schedule/` 一个目录**(没设 `DSC_HOME` 时就是它)。定时任务是插件,
6
+ * 插件不该往会话目录、技能目录里伸手;要清理就删这一个目录。
7
+ * 2. **写文件一律 tmp + rename**。JSON 整份重写,直接覆盖的话,写到一半断电会留下
8
+ * 半截 JSON;先写同目录的临时文件再 rename,读到的东西要么是旧的完整版、要么是新的完整版。
9
+ * 3. **所有写走一条 FIFO**。一个 tick 里可能连着推进好几条任务的 `nextRunAt`,
10
+ * 交织执行会各写一份旧内存快照、把别的改动吃掉。FIFO 把「读-改-写」串成一条链。
11
+ * 4. **至多一次靠 `pendingSlot`**:先把 `nextRunAt` 推到槽位之后并记下槽位,再去投递。
12
+ * 崩在中间时,重启能看见「推进了但没投」这个窗口,补投一次而不是每次重启都重投。
13
+ * (思路照 hermes `cron/occurrences.py:57-102`。)
14
+ * 5. **损坏兜底不抛错**:`tasks.json` 被手改坏、被别的进程写坏时,备份成 .corrupt、
15
+ * 按空清单继续跑,问题以一句话交给调用方去提示用户——一个坏文件不该让插件整个挂掉。
16
+ *
17
+ * @module dsc/core/schedule/store
18
+ */
19
+ import { appendFileSync, copyFileSync, existsSync, mkdirSync, readFileSync, renameSync, writeFileSync, } from 'node:fs';
20
+ import { join } from 'node:path';
21
+ import { isValidTimeZone, normalizeRule } from './rule.js';
22
+ import { dscPath } from '../path-policy.js';
23
+ /** 台账默认保留条数。再多也没人看,还会把文件撑到几兆。 */
24
+ export const DEFAULT_RUN_LIMIT = 1_000;
25
+ /** 投递历史默认保留条数。 */
26
+ export const DEFAULT_HISTORY_LIMIT = 200;
27
+ /** 投递历史默认保留天数。 */
28
+ export const DEFAULT_HISTORY_WINDOW_MS = 30 * 86_400_000;
29
+ /** 数据目录:`DSC_HOME` 优先(和仓库其他模块同一套约定),否则 `~/.dsc/schedule`。 */
30
+ export function scheduleDir() {
31
+ const home = process.env.DSC_HOME ?? dscPath();
32
+ return join(home, 'schedule');
33
+ }
34
+ function isFiniteNumber(value) {
35
+ return typeof value === 'number' && Number.isFinite(value);
36
+ }
37
+ /** 建一个新任务 id:时间有序(列表好读)+ 4 位随机(同一毫秒也不会撞)。 */
38
+ function newTaskId() {
39
+ return `sched-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
40
+ }
41
+ /**
42
+ * 把磁盘上的一项收敛成合法任务;认不出返回 null(调用方跳过并记账)。
43
+ * 磁盘文件是用户能手改的,属于不可信输入。
44
+ */
45
+ export function normalizeTask(value) {
46
+ if (value === null || typeof value !== 'object')
47
+ return null;
48
+ const raw = value;
49
+ const id = typeof raw.id === 'string' && raw.id !== '' ? raw.id : null;
50
+ const title = typeof raw.title === 'string' ? raw.title.trim() : '';
51
+ const prompt = typeof raw.prompt === 'string' ? raw.prompt : '';
52
+ const timeZone = typeof raw.timeZone === 'string' && isValidTimeZone(raw.timeZone) ? raw.timeZone : null;
53
+ const rule = normalizeRule(raw.rule);
54
+ if (id === null || title === '' || prompt === '' || timeZone === null || rule === null)
55
+ return null;
56
+ const status = raw.lastStatus;
57
+ return {
58
+ id,
59
+ title,
60
+ prompt,
61
+ rule,
62
+ timeZone,
63
+ enabled: raw.enabled !== false,
64
+ nextRunAt: isFiniteNumber(raw.nextRunAt) ? Math.round(raw.nextRunAt) : null,
65
+ lastRunAt: isFiniteNumber(raw.lastRunAt) ? Math.round(raw.lastRunAt) : null,
66
+ lastStatus: status === 'never' || status === 'running' || status === 'ok' || status === 'failed' ||
67
+ status === 'blocked' || status === 'skipped' || status === 'done'
68
+ ? status
69
+ : 'never',
70
+ lastError: typeof raw.lastError === 'string' && raw.lastError !== '' ? raw.lastError : null,
71
+ failureStreak: isFiniteNumber(raw.failureStreak) && raw.failureStreak > 0 ? Math.floor(raw.failureStreak) : 0,
72
+ pendingSlot: isFiniteNumber(raw.pendingSlot) ? Math.round(raw.pendingSlot) : null,
73
+ createdBy: typeof raw.createdBy === 'string' && raw.createdBy !== '' ? raw.createdBy : 'user',
74
+ deliveryHistory: Array.isArray(raw.deliveryHistory)
75
+ ? raw.deliveryHistory.filter(isFiniteNumber).map((entry) => Math.round(entry))
76
+ : [],
77
+ sessionId: typeof raw.sessionId === 'string' ? raw.sessionId : '',
78
+ createdAt: isFiniteNumber(raw.createdAt) ? Math.round(raw.createdAt) : 0,
79
+ updatedAt: isFiniteNumber(raw.updatedAt) ? Math.round(raw.updatedAt) : 0,
80
+ };
81
+ }
82
+ /** 复制一份任务再交出去:调用方改了不该影响 store 里的那份。 */
83
+ function cloneTask(task) {
84
+ return { ...task, deliveryHistory: [...task.deliveryHistory] };
85
+ }
86
+ export class ScheduleStore {
87
+ dir;
88
+ tasksFile;
89
+ runsFile;
90
+ lockFile;
91
+ runLimit;
92
+ historyLimit;
93
+ historyWindowMs;
94
+ clock;
95
+ tasks = [];
96
+ runLines = -1;
97
+ /** 写操作串行链:上一个无论如何结束,下一个才开始。 */
98
+ chain = Promise.resolve();
99
+ /** 最近一次读盘发现的问题,交给设置分区与命令显示。 */
100
+ lastProblem = null;
101
+ constructor(options = {}) {
102
+ this.dir = options.dir ?? scheduleDir();
103
+ this.tasksFile = join(this.dir, 'tasks.json');
104
+ this.runsFile = join(this.dir, 'runs.jsonl');
105
+ this.lockFile = join(this.dir, '.lock');
106
+ this.runLimit = options.runLimit ?? DEFAULT_RUN_LIMIT;
107
+ this.historyLimit = options.historyLimit ?? DEFAULT_HISTORY_LIMIT;
108
+ this.historyWindowMs = options.historyWindowMs ?? DEFAULT_HISTORY_WINDOW_MS;
109
+ this.clock = options.now ?? (() => Date.now());
110
+ }
111
+ /** 读盘时发现的问题(损坏兜底、跳过的坏条目)。 */
112
+ get problem() {
113
+ return this.lastProblem;
114
+ }
115
+ /**
116
+ * 改保留额度(设置分区里改了「历史保留条数」立刻生效,不必重启宿主)。
117
+ * @param limits - 台账条数与投递历史条数,都是 1 以上的整数
118
+ */
119
+ setLimits(limits) {
120
+ if (limits.runLimit !== undefined && Number.isFinite(limits.runLimit) && limits.runLimit > 0) {
121
+ this.runLimit = Math.floor(limits.runLimit);
122
+ }
123
+ if (limits.historyLimit !== undefined && Number.isFinite(limits.historyLimit) && limits.historyLimit > 0) {
124
+ this.historyLimit = Math.floor(limits.historyLimit);
125
+ }
126
+ }
127
+ /** 从磁盘读一遍任务清单(同步;文件很小,属于启动与 tick 前的必备动作)。 */
128
+ load() {
129
+ this.tasks = [];
130
+ this.lastProblem = null;
131
+ if (!existsSync(this.tasksFile))
132
+ return { tasks: [], problem: null };
133
+ let text = '';
134
+ try {
135
+ text = readFileSync(this.tasksFile, 'utf8');
136
+ }
137
+ catch (error) {
138
+ this.lastProblem = `任务文件读不动(${errorText(error)}),本次按空清单处理`;
139
+ return { tasks: [], problem: this.lastProblem };
140
+ }
141
+ let doc;
142
+ try {
143
+ doc = text.trim() === '' ? { tasks: [] } : JSON.parse(text);
144
+ }
145
+ catch (error) {
146
+ // 损坏兜底:先留一份副本(下一次写盘会覆盖原文件),再按空清单继续。
147
+ try {
148
+ if (!existsSync(`${this.tasksFile}.corrupt`))
149
+ copyFileSync(this.tasksFile, `${this.tasksFile}.corrupt`);
150
+ }
151
+ catch {
152
+ // 备份失败也要继续:能跑起来比留副本重要
153
+ }
154
+ this.lastProblem = `任务文件不是合法 JSON(${errorText(error)}),已备份为 tasks.json.corrupt,本次按空清单处理`;
155
+ return { tasks: [], problem: this.lastProblem };
156
+ }
157
+ let list = null;
158
+ if (Array.isArray(doc))
159
+ list = doc;
160
+ else if (doc !== null && typeof doc === 'object' && Array.isArray(doc.tasks)) {
161
+ list = doc.tasks;
162
+ }
163
+ if (list === null) {
164
+ this.lastProblem = '任务文件结构不认识(既不是数组,也没有 tasks 数组),本次按空清单处理';
165
+ return { tasks: [], problem: this.lastProblem };
166
+ }
167
+ const dropped = [];
168
+ const seen = new Set();
169
+ for (const entry of list) {
170
+ const task = normalizeTask(entry);
171
+ if (task === null) {
172
+ dropped.push(String(entry?.id ?? '(没有 id 的项)'));
173
+ continue;
174
+ }
175
+ // 同 id 只留最后一条:手改文件复制粘贴很容易撞 id。
176
+ if (seen.has(task.id))
177
+ this.tasks = this.tasks.filter((candidate) => candidate.id !== task.id);
178
+ seen.add(task.id);
179
+ this.tasks.push(this.trimHistory(task));
180
+ }
181
+ if (dropped.length > 0) {
182
+ this.lastProblem = `跳过了 ${dropped.length} 条认不出来的任务:${dropped.slice(0, 3).join('、')}${dropped.length > 3 ? ' …' : ''}`;
183
+ }
184
+ return { tasks: this.list(), problem: this.lastProblem };
185
+ }
186
+ /** 重新读盘(tick 前调用:别的进程刚写的改动要能看见)。 */
187
+ reload() {
188
+ return this.load();
189
+ }
190
+ /** 当前清单(复制出来的,改它不影响 store)。 */
191
+ list() {
192
+ return this.tasks.map(cloneTask);
193
+ }
194
+ get(id) {
195
+ const found = this.tasks.find((task) => task.id === id);
196
+ return found === undefined ? undefined : cloneTask(found);
197
+ }
198
+ /** 按 id 前缀找一条(命令里打 `a1b2` 比打全 id 顺手);命中多条返回 `ambiguous`。 */
199
+ findByPrefix(prefix) {
200
+ const key = prefix.trim();
201
+ if (key === '')
202
+ return { ok: false, error: '要给的:任务 id 或它的前缀' };
203
+ const exact = this.tasks.find((task) => task.id === key);
204
+ if (exact !== undefined)
205
+ return { ok: true, task: cloneTask(exact) };
206
+ const hits = this.tasks.filter((task) => task.id.startsWith(key) || task.title === key);
207
+ if (hits.length === 0)
208
+ return { ok: false, error: `没有匹配「${key}」的任务(用 /schedule list 看 id)` };
209
+ if (hits.length > 1)
210
+ return { ok: false, error: `「${key}」匹配到 ${hits.length} 条任务,请多给几位 id` };
211
+ return { ok: true, task: cloneTask(hits[0]) };
212
+ }
213
+ /** 新建一条任务并落盘。 */
214
+ create(input) {
215
+ return this.enqueue(() => {
216
+ const now = this.clock();
217
+ const task = {
218
+ id: newTaskId(),
219
+ title: input.title.trim(),
220
+ prompt: input.prompt,
221
+ rule: input.rule,
222
+ timeZone: input.timeZone,
223
+ enabled: input.enabled !== false,
224
+ // 排期由 runner 按规则算;这里先留 null,第一次 tick 会补上。
225
+ nextRunAt: null,
226
+ lastRunAt: null,
227
+ lastStatus: 'never',
228
+ lastError: null,
229
+ failureStreak: 0,
230
+ pendingSlot: null,
231
+ createdBy: input.createdBy ?? 'user',
232
+ deliveryHistory: [],
233
+ sessionId: input.sessionId ?? '',
234
+ createdAt: now,
235
+ updatedAt: now,
236
+ };
237
+ this.tasks.push(task);
238
+ this.persist();
239
+ return cloneTask(task);
240
+ });
241
+ }
242
+ /** 改一条任务(标题 / 描述 / 规则 / 时区 / 启停);改了规则或时区就把排期清空让 runner 重算。 */
243
+ update(id, patch) {
244
+ return this.enqueue(() => {
245
+ const index = this.tasks.findIndex((task) => task.id === id);
246
+ if (index < 0)
247
+ return null;
248
+ const current = this.tasks[index];
249
+ const next = { ...current, updatedAt: this.clock() };
250
+ if (patch.title !== undefined)
251
+ next.title = patch.title.trim();
252
+ if (patch.prompt !== undefined)
253
+ next.prompt = patch.prompt;
254
+ if (patch.timeZone !== undefined)
255
+ next.timeZone = patch.timeZone;
256
+ if (patch.enabled !== undefined)
257
+ next.enabled = patch.enabled;
258
+ if (patch.rule !== undefined) {
259
+ next.rule = patch.rule;
260
+ next.nextRunAt = null;
261
+ next.pendingSlot = null;
262
+ }
263
+ if (patch.timeZone !== undefined && patch.rule === undefined) {
264
+ next.nextRunAt = null;
265
+ next.pendingSlot = null;
266
+ }
267
+ this.tasks[index] = next;
268
+ this.persist();
269
+ return cloneTask(next);
270
+ });
271
+ }
272
+ /** 删一条任务;返回是否真的删掉了。 */
273
+ remove(id) {
274
+ return this.enqueue(() => {
275
+ const before = this.tasks.length;
276
+ this.tasks = this.tasks.filter((task) => task.id !== id);
277
+ if (this.tasks.length === before)
278
+ return false;
279
+ this.persist();
280
+ return true;
281
+ });
282
+ }
283
+ /**
284
+ * 至多一次的第一步:把 `nextRunAt` 推到 `next`(null = 到此为止)、记下 `pendingSlot`,落盘。
285
+ * 这一步落盘之后才允许投递——崩在投递中途也不会在重启后重投(靠 pendingSlot 补一次)。
286
+ */
287
+ beginSlot(id, slot, next) {
288
+ return this.enqueue(() => {
289
+ const index = this.tasks.findIndex((task) => task.id === id);
290
+ if (index < 0)
291
+ return null;
292
+ const now = this.clock();
293
+ const next2 = {
294
+ ...this.tasks[index],
295
+ nextRunAt: next,
296
+ pendingSlot: slot,
297
+ lastRunAt: slot,
298
+ lastStatus: 'running',
299
+ updatedAt: now,
300
+ };
301
+ this.tasks[index] = next2;
302
+ this.persist();
303
+ return cloneTask(next2);
304
+ });
305
+ }
306
+ /** 投递结束(成功、定性失败、被跳过都算)后清 `pendingSlot` 并记账。 */
307
+ endSlot(id, outcome) {
308
+ return this.enqueue(() => {
309
+ const index = this.tasks.findIndex((task) => task.id === id);
310
+ if (index < 0)
311
+ return null;
312
+ const current = this.tasks[index];
313
+ const now = this.clock();
314
+ const streak = outcome.failureStreak ??
315
+ (outcome.status === 'failed' ? current.failureStreak + 1 : outcome.status === 'ok' ? 0 : current.failureStreak);
316
+ const next = {
317
+ ...current,
318
+ pendingSlot: null,
319
+ lastStatus: outcome.status,
320
+ lastError: outcome.error === undefined || outcome.error === null || outcome.error === '' ? null : outcome.error,
321
+ failureStreak: streak,
322
+ updatedAt: now,
323
+ };
324
+ if (outcome.nextRunAt !== undefined)
325
+ next.nextRunAt = outcome.nextRunAt;
326
+ if (outcome.delivered === true)
327
+ next.deliveryHistory = this.appendHistory(current.deliveryHistory, now);
328
+ this.tasks[index] = this.trimHistory(next);
329
+ this.persist();
330
+ return cloneTask(next);
331
+ });
332
+ }
333
+ /** 只改排期(tick 里给没到点的任务补算 nextRunAt 用)。 */
334
+ setNextRunAt(id, next) {
335
+ return this.enqueue(() => {
336
+ const index = this.tasks.findIndex((task) => task.id === id);
337
+ if (index < 0)
338
+ return null;
339
+ const next2 = { ...this.tasks[index], nextRunAt: next, updatedAt: this.clock() };
340
+ this.tasks[index] = next2;
341
+ this.persist();
342
+ return cloneTask(next2);
343
+ });
344
+ }
345
+ /** 已经推进、还没投递完的任务(进程崩在投递中途的现场)。 */
346
+ pendingTasks() {
347
+ return this.tasks.filter((task) => task.pendingSlot !== null).map(cloneTask);
348
+ }
349
+ /** 追加一条执行台账;超过上限就裁到最近 runLimit 条。 */
350
+ appendRun(run) {
351
+ return this.enqueue(() => {
352
+ this.appendRunSync(run);
353
+ });
354
+ }
355
+ /** 读最近若干条台账(新的在前)。文件不存在或整行坏掉都不抛错。 */
356
+ recentRuns(limit = 20) {
357
+ if (!existsSync(this.runsFile))
358
+ return [];
359
+ let lines;
360
+ try {
361
+ lines = readFileSync(this.runsFile, 'utf8').split('\n');
362
+ }
363
+ catch {
364
+ return [];
365
+ }
366
+ const out = [];
367
+ for (let index = lines.length - 1; index >= 0 && out.length < limit; index -= 1) {
368
+ const line = lines[index].trim();
369
+ if (line === '')
370
+ continue;
371
+ try {
372
+ const parsed = JSON.parse(line);
373
+ if (parsed !== null && typeof parsed === 'object')
374
+ out.push(parsed);
375
+ }
376
+ catch {
377
+ // 半截行(进程被杀)跳过就行,不值得为它报错
378
+ }
379
+ }
380
+ return out;
381
+ }
382
+ // ── 内部 ────────────────────────────────────────────────────────────────────
383
+ /** FIFO:把一次读-改-写挂到链尾。前一个失败不阻塞后一个。 */
384
+ enqueue(operation) {
385
+ const run = this.chain.then(operation, operation);
386
+ this.chain = run.then(() => undefined, () => undefined);
387
+ return run;
388
+ }
389
+ /** 整份重写 tasks.json(tmp + rename 原子替换)。 */
390
+ persist() {
391
+ mkdirSync(this.dir, { recursive: true });
392
+ const text = `${JSON.stringify({ version: 1, tasks: this.tasks }, null, 2)}\n`;
393
+ const tmp = `${this.tasksFile}.${process.pid}.tmp`;
394
+ writeFileSync(tmp, text, 'utf8');
395
+ renameSync(tmp, this.tasksFile);
396
+ }
397
+ appendRunSync(run) {
398
+ mkdirSync(this.dir, { recursive: true });
399
+ appendFileSync(this.runsFile, `${JSON.stringify(run)}\n`, 'utf8');
400
+ const lines = this.countRunLines() + 1;
401
+ this.runLines = lines;
402
+ if (lines > this.runLimit)
403
+ this.compactRuns();
404
+ }
405
+ /** 数台账行数(数一次记下来;只有本进程会写它,因为有 .lock 互斥)。 */
406
+ countRunLines() {
407
+ if (this.runLines >= 0)
408
+ return this.runLines;
409
+ if (!existsSync(this.runsFile)) {
410
+ this.runLines = 0;
411
+ return 0;
412
+ }
413
+ try {
414
+ const text = readFileSync(this.runsFile, 'utf8');
415
+ this.runLines = text.split('\n').filter((line) => line.trim() !== '').length;
416
+ }
417
+ catch {
418
+ this.runLines = 0;
419
+ }
420
+ return this.runLines;
421
+ }
422
+ /** 把台账裁到最近 runLimit 条(同样 tmp + rename)。 */
423
+ compactRuns() {
424
+ let lines = [];
425
+ try {
426
+ lines = readFileSync(this.runsFile, 'utf8').split('\n').filter((line) => line.trim() !== '');
427
+ }
428
+ catch {
429
+ return;
430
+ }
431
+ const kept = lines.slice(Math.max(0, lines.length - this.runLimit));
432
+ const tmp = `${this.runsFile}.${process.pid}.tmp`;
433
+ writeFileSync(tmp, kept.length === 0 ? '' : `${kept.join('\n')}\n`, 'utf8');
434
+ renameSync(tmp, this.runsFile);
435
+ this.runLines = kept.length;
436
+ }
437
+ /** 投递历史:先按 30 天砍,再按 200 条砍。 */
438
+ appendHistory(history, at) {
439
+ const cutoff = at - this.historyWindowMs;
440
+ const kept = [...history.filter((entry) => entry >= cutoff), at];
441
+ return kept.slice(Math.max(0, kept.length - this.historyLimit));
442
+ }
443
+ /** 读盘 / 落盘时顺手裁一下历史(老文件里可能积了很多)。 */
444
+ trimHistory(task) {
445
+ const cutoff = this.clock() - this.historyWindowMs;
446
+ const kept = task.deliveryHistory.filter((entry) => entry >= cutoff);
447
+ return { ...task, deliveryHistory: kept.slice(Math.max(0, kept.length - this.historyLimit)) };
448
+ }
449
+ }
450
+ /** 把 catch 到的东西变成一句话(`useUnknownInCatchVariables` 下不能直接当 Error 用)。 */
451
+ export function errorText(error) {
452
+ if (error instanceof Error)
453
+ return error.message;
454
+ return String(error);
455
+ }
@@ -0,0 +1,41 @@
1
+ /**
2
+ * 凭据遮红与环境脱敏:不让密钥从这三条路漏出去——
3
+ * 1. 子进程继承到 dsc 自己的 API key,被模型诱导的脚本读走;
4
+ * 2. 工具输出里的密钥原样进会话日志和界面;
5
+ * 3. 会话文件落盘后被人当普通文本翻出来。
6
+ *
7
+ * 做法照 Hermes 的 `agent/redact.py` 与 `tools/code_execution_env.py:52`:
8
+ * 一把正则扫文本,一份名单剥环境变量,开关在进程启动时冻结(运行中不许改)。
9
+ *
10
+ * @module dsc/core/secrets
11
+ */
12
+ /** 遮红结果:替换后的文本与命中条数。 */
13
+ export interface RedactResult {
14
+ text: string;
15
+ /** 命中并替换掉的段数(0 = 这段没有密钥形状)。 */
16
+ replaced: number;
17
+ /** 命中的规则名(进审计日志,不进正文,免得反向泄露)。 */
18
+ kinds: string[];
19
+ }
20
+ /**
21
+ * 把文本里密钥形状的字符串换成占位。
22
+ *
23
+ * 作用点:工具结果进会话前、审批卡摘要、会话日志落盘前、界面显示。
24
+ * 关闭开关只影响这一层(`DSC_REDACT=0`),不影响下面的环境脱敏。
25
+ */
26
+ export declare function redactText(input: string): RedactResult;
27
+ /** 只要遮红后的文本(大多数调用方不关心命中数)。 */
28
+ export declare function redact(input: string): string;
29
+ /** 剥完的结果,附带被剥掉的变量名(进审计,值绝不进)。 */
30
+ export interface ScrubResult {
31
+ env: Record<string, string | undefined>;
32
+ stripped: string[];
33
+ }
34
+ /**
35
+ * 剥掉要跑的子进程环境里的凭据。
36
+ *
37
+ * 默认关死:命中密钥形状的变量名一律剥;`DSC_ENV_PASS` 只能放行没命中密钥形状的普通变量,
38
+ * 命中密钥形状的怎么都不给(Hermes 的 `env_passthrough` 白名单也是这个次序)。
39
+ * dsc 自己的 provider key 从 `~/.dsc/credentials.yaml` 走请求头,不靠环境变量,所以剥掉不影响对话。
40
+ */
41
+ export declare function scrubChildEnv(source: NodeJS.ProcessEnv | Record<string, string | undefined>): ScrubResult;