@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,854 @@
1
+ /**
2
+ * 技能写入:SKILL.md 的硬校验、写入后安全扫描(不过就还原)、归档、使用台账与老化分级。
3
+ *
4
+ * 为什么硬校验要卡在写盘之前、扫描要卡在写盘之后:
5
+ * - 校验(frontmatter / description ≤60 字符 / 正文非空 / 体积上限)是「这份技能还能不能
6
+ * 被模型正确路由」的问题,写之前就能判,所以一个字节都不落盘;
7
+ * - 安全扫描是「这份技能会不会变成注入载荷」的问题,它看的是整份目录,只能在写完之后跑;
8
+ * 不过就把原内容盖回去(新建的则删掉),并把原因回给模型——技能正文会被下一次的我
9
+ * 当成操作手册照做,这里放过去等于给自己留一条后门。
10
+ *
11
+ * 三条硬规矩(对齐 hermes 的 `skill_manager_tool`):read-before-write(本会话没读过就拒)、
12
+ * 改前留副本(`SKILL.md.bak.<秒级时间戳>`)、归档只搬不删(`.archive/<名字>-<戳>/`)。
13
+ *
14
+ * 使用台账与老化分级也在这里:`~/.dsc/skills/.usage.json` 记命中计数与活跃时间,
15
+ * `active → stale(14 天未命中)→ archived(30 天)`。**只有 `createdBy: 'agent'` 的技能
16
+ * 会被自动归档**——用户手写的技能被自动搬走,是这份功能最不该做的事。
17
+ *
18
+ * 与 ledger.ts 之间有一处双向 import(这里要记台账、台账要读技能目录布局)。两边都只在
19
+ * 函数里互相调用,模块顶层不做任何跨文件取值,所以 ESM 的循环求值是安全的。
20
+ *
21
+ * @module dsc/core/learnings/skill-write
22
+ */
23
+ import { existsSync, mkdirSync, readdirSync, readFileSync, renameSync, rmdirSync, statSync, unlinkSync, writeFileSync } from 'node:fs';
24
+ import { dirname, join, relative, resolve, sep } from 'node:path';
25
+ import { contentText } from '../llm.js';
26
+ import { DSC_SKILLS_DIR, parseSkillMarkdown, scanSkillRoot, splitFrontmatter, writeSkillEnabled } from '../skills.js';
27
+ import { appendLedger, copyToBackup, EMPTY_HASH, hashText } from './ledger.js';
28
+ /** 技能主文件名。 */
29
+ export const SKILL_FILE = 'SKILL.md';
30
+ /** 技能根目录(用户级技能目录,与 core/skills.js 的 DSC_SKILLS_DIR 是同一个)。 */
31
+ export function skillsRoot() {
32
+ return DSC_SKILLS_DIR;
33
+ }
34
+ /** 归档区(只进不出地堆在这里,永不删)。 */
35
+ export function archiveRoot() {
36
+ return join(skillsRoot(), '.archive');
37
+ }
38
+ /** 使用台账文件。 */
39
+ export function usageFile() {
40
+ return join(skillsRoot(), '.usage.json');
41
+ }
42
+ export const DEFAULT_SKILL_LIMITS = {
43
+ descriptionMax: 60,
44
+ bodyMax: 20 * 1024,
45
+ nameMax: 64,
46
+ fileMax: 256 * 1024,
47
+ };
48
+ /** 可以放附属文件的子目录(与 hermes 的 ALLOWED_SUBDIRS 一致,去掉 assets 换成 dsc 习惯的 assets 保留)。 */
49
+ export const ALLOWED_SUBDIRS = ['references', 'templates', 'scripts', 'assets'];
50
+ /** 技能名规则:kebab-case(与 core/skills.js 一致)。 */
51
+ const NAME_PATTERN = /^[a-z0-9]+(?:-[a-z0-9]+)*$/;
52
+ /** 字符数(按码点算,表情符号不会被算成两个字符)。 */
53
+ function charCount(text) {
54
+ return [...text].length;
55
+ }
56
+ /** 名字合法吗;不合法给一句中文原因。 */
57
+ export function validateSkillName(name, limits = DEFAULT_SKILL_LIMITS) {
58
+ const trimmed = name.trim();
59
+ if (trimmed === '')
60
+ return '技能名不能空着';
61
+ if (charCount(trimmed) > limits.nameMax)
62
+ return `技能名超过 ${String(limits.nameMax)} 个字符`;
63
+ if (!NAME_PATTERN.test(trimmed)) {
64
+ return `技能名「${trimmed}」不是 kebab-case(小写字母数字用短横线相连,例如 git-workflow)`;
65
+ }
66
+ return '';
67
+ }
68
+ /**
69
+ * 校验一份 SKILL.md 全文。
70
+ *
71
+ * 为什么 description 超限是**拒**而不是截断:技能目录里那份 description 是模型决定「要不要
72
+ * 加载这个技能」的唯一依据,截到 57 字符加省略号会把触发词本身砍掉(用户写「当用户说……
73
+ * 的时候」就没了后半句),于是这个技能永远不会被选中——静默失效比报错难查得多。
74
+ */
75
+ export function validateSkillMarkdown(text, limits = DEFAULT_SKILL_LIMITS) {
76
+ if (text.trim() === '')
77
+ return { ok: false, error: '技能正文是空的', fields: null };
78
+ if (charCount(text) > limits.bodyMax) {
79
+ return {
80
+ ok: false,
81
+ error: `技能正文 ${String(charCount(text))} 字符,超过 ${String(limits.bodyMax)} 的上限:把细节挪到 references/ 下的附属文件,SKILL.md 只留每次都要用的步骤`,
82
+ fields: null,
83
+ };
84
+ }
85
+ const { front, body } = splitFrontmatter(text);
86
+ if (front.trim() === '') {
87
+ return { ok: false, error: 'SKILL.md 必须以 YAML frontmatter(第一行 ---)开头,里面写 name、description、whenToUse', fields: null };
88
+ }
89
+ const parsed = parseSkillMarkdown(text);
90
+ if (parsed.name === undefined) {
91
+ return { ok: false, error: 'frontmatter 里缺 name,或者 name 不是字符串(kebab-case,例如 git-workflow)', fields: null };
92
+ }
93
+ const nameProblem = validateSkillName(parsed.name, limits);
94
+ if (nameProblem !== '')
95
+ return { ok: false, error: nameProblem, fields: null };
96
+ if (parsed.description === '')
97
+ return { ok: false, error: 'frontmatter 里缺 description(一句话写清做什么,它进模型可见目录)', fields: null };
98
+ if (charCount(parsed.description) > limits.descriptionMax) {
99
+ return {
100
+ ok: false,
101
+ error: `description 有 ${String(charCount(parsed.description))} 个字符,超过 ${String(limits.descriptionMax)} 的上限:技能目录会把超出的部分砍掉、触发词就没了,请缩短后重写`,
102
+ fields: null,
103
+ };
104
+ }
105
+ if (parsed.whenToUse === undefined) {
106
+ return { ok: false, error: 'frontmatter 里缺 whenToUse(什么情况下该用这个技能),例如 whenToUse: 用户说「部署」的时候', fields: null };
107
+ }
108
+ if (body.trim() === '') {
109
+ return { ok: false, error: 'frontmatter 之后必须有正文(步骤、命令、注意事项),不能是空技能', fields: null };
110
+ }
111
+ return {
112
+ ok: true,
113
+ error: '',
114
+ fields: { name: parsed.name, description: parsed.description, whenToUse: parsed.whenToUse, content: body.trim() },
115
+ };
116
+ }
117
+ /** 校验一份结构化草稿(L2 复盘与 `/learn` 走这条,插件自己拼 frontmatter)。 */
118
+ export function validateSkillDraft(draft, limits = DEFAULT_SKILL_LIMITS) {
119
+ const nameProblem = validateSkillName(draft.name, limits);
120
+ if (nameProblem !== '')
121
+ return { ok: false, error: nameProblem, fields: null };
122
+ const markdown = renderSkillMarkdown(draft);
123
+ const result = validateSkillMarkdown(markdown, limits);
124
+ if (!result.ok)
125
+ return result;
126
+ return { ok: true, error: '', fields: draft };
127
+ }
128
+ /**
129
+ * 把草稿拼成 SKILL.md 全文。
130
+ *
131
+ * frontmatter 的取值一律双引号包起来(JSON 字符串是合法 YAML 标量):description 里出现
132
+ * 冒号、引号、`#` 都不会把 YAML 解析带偏。`created_by: agent` 由这里盖章,
133
+ * 不接受调用方传值——它是「这份技能归自动化维护」的标记,老化归档只认它。
134
+ */
135
+ export function renderSkillMarkdown(draft) {
136
+ const quote = (value) => JSON.stringify(value.trim());
137
+ const body = draft.content.replace(/\r\n/g, '\n').trim();
138
+ return [
139
+ '---',
140
+ `name: ${quote(draft.name)}`,
141
+ `description: ${quote(draft.description)}`,
142
+ `whenToUse: ${quote(draft.whenToUse)}`,
143
+ 'created_by: agent',
144
+ '---',
145
+ '',
146
+ body,
147
+ '',
148
+ ].join('\n');
149
+ }
150
+ // ── 写后安全扫描 ───────────────────────────────────────────────────────────────
151
+ /** 不可见字符(零宽空格、方向控制符、标签字符、BOM)。全用转义写:源码里不该出现看不见的内容。 */
152
+ const INVISIBLE = new RegExp('[\\u00AD\\u200B-\\u200F\\u2028\\u2029\\u2060-\\u2064\\uFEFF\\u{E0000}-\\u{E007F}]', 'gu');
153
+ /**
154
+ * 技能正文的安检表(自己实现一份,不 import 内核记忆那套私有规则)。
155
+ *
156
+ * 拦的不是脏话,而是「一段能让下一次的我把技能当指令去执行」的载体:叫模型忽略既有规则、
157
+ * 别告诉用户、冒充系统消息、藏不可见字符,以及一大段编码载荷。危险命令(rm -rf 之类)
158
+ * 不在这里拦——正经的运维技能正文里会写它,交给命令策略与审批那一层管。
159
+ */
160
+ const THREAT_RULES = [
161
+ { label: '藏着不可见字符(零宽空格、方向控制符这类,肉眼看不见但模型看得见)', pattern: INVISIBLE },
162
+ {
163
+ label: '叫模型忽略它自己收到的指令',
164
+ pattern: /(忽略|无视|忘掉)[^。\n]{0,10}(指令|规则|约束|限制|系统提示)|ignore\s+(?:all\s+|the\s+)?(?:previous|prior|above|system)\s+(?:instruction|rule|prompt)/iu,
165
+ },
166
+ {
167
+ label: '叫模型别把看到的东西告诉用户',
168
+ pattern: /(不要|别)(告诉|提醒|通知|提及)[^。\n]{0,8}(用户|使用者)|do\s+not\s+(?:tell|inform|mention)[\s,]+(?:the\s+)?user/iu,
169
+ },
170
+ { label: '冒充系统消息或新的系统提示', pattern: /new\s+system\s+prompt|\[SYSTEM\]|<\|?system\|?>|我是系统提示/iu },
171
+ { label: '一大段 base64 形状的载荷(200 字符以上)', pattern: /[A-Za-z0-9+/]{200,}={0,2}/u },
172
+ {
173
+ label: '一段编码后的载荷配着执行',
174
+ pattern: /(base64|atob|fromCharCode|Convert\.FromBase64)[^\n]{0,40}(?:eval|exec|spawn|powershell|bash|Invoke-Expression)/iu,
175
+ },
176
+ {
177
+ label: '把凭据原文写进了技能(形如 sk-… / AKIA… / eyJ… 的长串)',
178
+ pattern: /\b(?:sk|pk|ghp|gho|xoxb|AKIA)[-_][A-Za-z0-9]{12,}\b|\beyJ[A-Za-z0-9_-]{20,}/u,
179
+ },
180
+ {
181
+ label: '想把这条安检或技能台账绕过去',
182
+ pattern: /(\.ledger\.jsonl|skill-write|skill_write)[^。\n]{0,14}(关掉|放开|绕过|改成|删掉)|(绕过|跳过)[^。\n]{0,6}(安检|扫描)/iu,
183
+ },
184
+ ];
185
+ /**
186
+ * 一段技能文本过不过安检。
187
+ *
188
+ * @returns 拦下的原因;空串表示放行。先做 NFKC 归一:全角与兼容字符先换成一副正经面孔再判,
189
+ * 不然一个全角的「ignore」就能绕过去。
190
+ */
191
+ export function scanSkillThreat(text) {
192
+ const normalized = text.normalize('NFKC');
193
+ for (const rule of THREAT_RULES) {
194
+ rule.pattern.lastIndex = 0;
195
+ if (rule.pattern.test(normalized))
196
+ return rule.label;
197
+ }
198
+ return '';
199
+ }
200
+ /** 整份技能目录的安检:SKILL.md 加全部附属文件一起看。 */
201
+ export function scanSkillDir(dir) {
202
+ const stack = [dir];
203
+ while (stack.length > 0) {
204
+ const current = stack.pop();
205
+ let entries;
206
+ try {
207
+ entries = readdirSync(current, { withFileTypes: true });
208
+ }
209
+ catch {
210
+ continue;
211
+ }
212
+ for (const entry of entries) {
213
+ const full = join(current, entry.name);
214
+ if (entry.isDirectory()) {
215
+ stack.push(full);
216
+ continue;
217
+ }
218
+ // 副本与临时文件不参与扫描:它们是原文件的影子,扫出问题也不是新引入的
219
+ if (entry.name.includes('.bak.') || entry.name.endsWith('.tmp'))
220
+ continue;
221
+ try {
222
+ if (statSync(full).size > DEFAULT_SKILL_LIMITS.fileMax)
223
+ return `${relative(dir, full)} 超过单个文件 ${String(DEFAULT_SKILL_LIMITS.fileMax)} 字节的上限`;
224
+ const reason = scanSkillThreat(readFileSync(full, 'utf8'));
225
+ if (reason !== '')
226
+ return `${relative(dir, full)}:${reason}`;
227
+ }
228
+ catch {
229
+ continue;
230
+ }
231
+ }
232
+ }
233
+ return '';
234
+ }
235
+ // ── 落盘 ───────────────────────────────────────────────────────────────────────
236
+ /** 原子写文本:tmp + rename(Windows 上 rename 会覆盖目标,所以不需要先删)。 */
237
+ export function atomicWriteText(file, text) {
238
+ mkdirSync(dirname(file), { recursive: true });
239
+ const tmp = `${file}.tmp`;
240
+ writeFileSync(tmp, text, 'utf8');
241
+ try {
242
+ renameSync(tmp, file);
243
+ }
244
+ catch (error) {
245
+ try {
246
+ unlinkSync(tmp);
247
+ }
248
+ catch {
249
+ // 临时文件已经不在了:忽略
250
+ }
251
+ throw error;
252
+ }
253
+ }
254
+ /** 技能目录路径。 */
255
+ export function skillDirOf(name) {
256
+ return join(skillsRoot(), name);
257
+ }
258
+ /** 技能正文文件路径。 */
259
+ export function skillFileOf(name) {
260
+ return join(skillDirOf(name), SKILL_FILE);
261
+ }
262
+ function errText(error) {
263
+ return error instanceof Error ? error.message : String(error);
264
+ }
265
+ function fail(error) {
266
+ return { ok: false, error, notice: '', entry: null, backup: '' };
267
+ }
268
+ /** 落盘 + 写台账,任何一步失败都转成中文原因。 */
269
+ function finishWrite(draft, notice, backup) {
270
+ try {
271
+ const entry = appendLedger(draft);
272
+ return { ok: true, error: '', notice, entry, backup };
273
+ }
274
+ catch (error) {
275
+ // 台账写不进去不影响技能已经写好的事实:如实说出来,但不把这次写入判失败
276
+ return { ok: true, error: '', notice: `${notice}(台账没写成:${errText(error)})`, entry: null, backup };
277
+ }
278
+ }
279
+ /**
280
+ * 新建一个技能:校验 → 落盘 → 写后扫描(不过就删掉刚写的文件)→ 记台账 → **写进停用名单**。
281
+ *
282
+ * 为什么默认停用:一份刚由模型自己写出来的技能,还没经过用户看过一眼就进模型目录,
283
+ * 等于让模型用它自己写的手册指挥自己。停用之后用户 `/skills` 里点一下才生效。
284
+ */
285
+ export function createSkill(input) {
286
+ const limits = input.limits ?? DEFAULT_SKILL_LIMITS;
287
+ const nameProblem = validateSkillName(input.name, limits);
288
+ if (nameProblem !== '')
289
+ return fail(nameProblem);
290
+ const validated = validateSkillMarkdown(input.markdown, limits);
291
+ if (!validated.ok || validated.fields === null)
292
+ return fail(validated.error);
293
+ if (validated.fields.name !== input.name) {
294
+ return fail(`frontmatter 里的 name「${validated.fields.name}」与要创建的名字「${input.name}」对不上:两者必须一致,否则技能中心显示的名字与目录名是两回事`);
295
+ }
296
+ const dir = skillDirOf(input.name);
297
+ if (existsSync(dir)) {
298
+ return fail(`技能 ${input.name} 已经存在(${dir}):要改它用 patch,别用 create(create 不会覆盖别人的技能)`);
299
+ }
300
+ const file = skillFileOf(input.name);
301
+ try {
302
+ mkdirSync(dir, { recursive: true });
303
+ atomicWriteText(file, input.markdown);
304
+ }
305
+ catch (error) {
306
+ return fail(`技能没能写进磁盘:${errText(error)}`);
307
+ }
308
+ const threat = scanSkillDir(dir);
309
+ if (threat !== '') {
310
+ // 新建的这份没过安检:连同目录一起收拾掉(目录是我们刚建的,里面只有这一个文件)
311
+ try {
312
+ unlinkSync(file);
313
+ rmdirSync(dir);
314
+ }
315
+ catch {
316
+ // 收拾不干净就留着,至少内容已经删掉了
317
+ }
318
+ return fail(`这份技能没过安全扫描,已经撤销:${threat}`);
319
+ }
320
+ let notice = '';
321
+ try {
322
+ writeSkillEnabled(input.name, false);
323
+ }
324
+ catch (error) {
325
+ notice = `(停用名单没写成,技能可能直接进模型目录,请在 /skills 里确认:${errText(error)})`;
326
+ }
327
+ // 使用台账:`created_by: agent` 是允许自动化维护它的唯一凭据(老化归档只认这一个标记)
328
+ recordSkillCreated(input.name, input.now ?? Date.now(), 'agent');
329
+ return finishWrite({
330
+ actor: input.actor,
331
+ action: 'create',
332
+ skill: input.name,
333
+ beforeHash: EMPTY_HASH,
334
+ afterHash: hashText(input.markdown),
335
+ note: `新建 ${input.name}(默认停用,等用户在 /skills 启用)`,
336
+ }, `已建技能 ${input.name}(默认停用,/skills 里启用后才进模型可见目录)${notice}`, '');
337
+ }
338
+ /**
339
+ * 改一处:先在内存里改,校验整份新内容,再留副本、落盘、扫描;不过就把原内容盖回去。
340
+ *
341
+ * 顺序不能反:先留副本再落盘(不然崩溃就两头空),先校验再落盘(不然写进去一份缺
342
+ * frontmatter 的文件,技能中心当场读不出来)。
343
+ */
344
+ export function patchSkill(input) {
345
+ const limits = input.limits ?? DEFAULT_SKILL_LIMITS;
346
+ const file = skillFileOf(input.name);
347
+ if (!existsSync(file))
348
+ return fail(`技能 ${input.name} 不存在(${file}):先 create,或者确认名字拼对了`);
349
+ if (!input.readConfirmed) {
350
+ return fail(`改 ${input.name} 之前得先读它:本会话还没用 skill 工具读过这个技能,先读一遍再改(读到的内容才是你要改的那份)`);
351
+ }
352
+ if (input.oldString === '')
353
+ return fail('old_string 不能是空的:要说清楚改哪一段');
354
+ let original = '';
355
+ try {
356
+ original = readFileSync(file, 'utf8');
357
+ }
358
+ catch (error) {
359
+ return fail(`技能读不出来:${errText(error)}`);
360
+ }
361
+ const hits = original.split(input.oldString).length - 1;
362
+ if (hits === 0)
363
+ return fail(`在 ${input.name}/SKILL.md 里找不到要替换的那段文字(片段要对得上,包括缩进与换行)`);
364
+ if (hits > 1 && input.replaceAll !== true) {
365
+ return fail(`这段文字在 ${input.name}/SKILL.md 里出现了 ${String(hits)} 次:要么把片段写得更具体,要么显式传 replace_all`);
366
+ }
367
+ const next = input.replaceAll === true ? original.split(input.oldString).join(input.newString) : original.replace(input.oldString, input.newString);
368
+ const validated = validateSkillMarkdown(next, limits);
369
+ if (!validated.ok)
370
+ return fail(`这样改会把 SKILL.md 改坏:${validated.error}`);
371
+ const backup = copyToBackup(file, input.now);
372
+ try {
373
+ atomicWriteText(file, next);
374
+ }
375
+ catch (error) {
376
+ return fail(`技能没能写进磁盘:${errText(error)}`);
377
+ }
378
+ const threat = scanSkillDir(skillDirOf(input.name));
379
+ if (threat !== '') {
380
+ try {
381
+ atomicWriteText(file, original);
382
+ }
383
+ catch (error) {
384
+ return fail(`写后扫描没过(${threat}),而且原内容也没盖回去:${errText(error)}。原内容在副本 ${backup === '' ? '(没留下)' : backup} 里`);
385
+ }
386
+ return fail(`写后扫描没过,已经把原内容盖回去了:${threat}`);
387
+ }
388
+ bumpSkillPatch(input.name, input.now ?? Date.now());
389
+ return finishWrite({
390
+ actor: input.actor,
391
+ action: 'patch',
392
+ skill: input.name,
393
+ beforeHash: hashText(original),
394
+ afterHash: hashText(next),
395
+ ...(backup === '' ? {} : { backup }),
396
+ note: '改一处',
397
+ }, `已改 ${input.name}/SKILL.md${backup === '' ? '' : `(改前的内容在副本 ${backup} 里)`}`, backup);
398
+ }
399
+ /** 附属文件路径的合法性检查:不许跳出技能目录,必须落在允许的子目录里。 */
400
+ export function validateSkillFilePath(filePath) {
401
+ const raw = filePath.trim().replace(/\\/g, '/');
402
+ if (raw === '')
403
+ return 'file_path 不能空着';
404
+ if (raw.startsWith('/') || /^[a-zA-Z]:/.test(raw))
405
+ return 'file_path 只能是相对技能目录的路径';
406
+ const parts = raw.split('/').filter((part) => part !== '' && part !== '.');
407
+ if (parts.some((part) => part === '..'))
408
+ return "file_path 里不许出现 '..'";
409
+ if (parts.length < 2)
410
+ return `附属文件要放在子目录里:${ALLOWED_SUBDIRS.join(' / ')} 之下,例如 references/example.md`;
411
+ if (!ALLOWED_SUBDIRS.includes(parts[0] ?? '')) {
412
+ return `附属文件只能放在 ${ALLOWED_SUBDIRS.join(' / ')} 之下,收到的是「${parts[0] ?? ''}」`;
413
+ }
414
+ return '';
415
+ }
416
+ /** 写一个附属文件(references/scripts 这类):路径受辖、体积受辖、写后照样过安检。 */
417
+ export function writeSkillFile(input) {
418
+ const limits = input.limits ?? DEFAULT_SKILL_LIMITS;
419
+ const dir = skillDirOf(input.name);
420
+ if (!existsSync(skillFileOf(input.name)))
421
+ return fail(`技能 ${input.name} 不存在:先 create 再用 write_file 加附属文件`);
422
+ const pathProblem = validateSkillFilePath(input.filePath);
423
+ if (pathProblem !== '')
424
+ return fail(pathProblem);
425
+ const relativePath = input.filePath.trim().replace(/\\/g, '/');
426
+ const target = resolve(dir, relativePath);
427
+ const root = resolve(dir);
428
+ if (target !== root && !target.startsWith(root + sep)) {
429
+ return fail(`写入目标跑到技能目录外面去了,拒绝:${relativePath}`);
430
+ }
431
+ if (Buffer.byteLength(input.content, 'utf8') > limits.fileMax) {
432
+ return fail(`单个附属文件不能超过 ${String(limits.fileMax)} 字节`);
433
+ }
434
+ const exists = existsSync(target);
435
+ if (exists && !input.readConfirmed) {
436
+ return fail(`覆盖 ${input.name}/${relativePath} 之前得先读它:本会话还没用 skill 工具读过这个技能`);
437
+ }
438
+ const original = exists ? readFileSync(target, 'utf8') : '';
439
+ const backup = exists ? copyToBackup(target, input.now) : '';
440
+ try {
441
+ atomicWriteText(target, input.content);
442
+ }
443
+ catch (error) {
444
+ return fail(`附属文件没能写进磁盘:${errText(error)}`);
445
+ }
446
+ const threat = scanSkillDir(dir);
447
+ if (threat !== '') {
448
+ try {
449
+ if (exists)
450
+ atomicWriteText(target, original);
451
+ else
452
+ unlinkSync(target);
453
+ }
454
+ catch (error) {
455
+ return fail(`写后扫描没过(${threat}),而且回滚也没做成:${errText(error)}`);
456
+ }
457
+ return fail(`写后扫描没过,已经撤销这次写入:${threat}`);
458
+ }
459
+ bumpSkillPatch(input.name, input.now ?? Date.now());
460
+ return finishWrite({
461
+ actor: input.actor,
462
+ action: 'write_file',
463
+ skill: input.name,
464
+ beforeHash: exists ? hashText(original) : EMPTY_HASH,
465
+ afterHash: hashText(input.content),
466
+ ...(backup === '' ? {} : { backup }),
467
+ note: relativePath,
468
+ }, `已写 ${input.name}/${relativePath}${backup === '' ? '' : `(原文件在副本 ${backup} 里)`}`, backup);
469
+ }
470
+ /** 秒级时间戳折成 `YYYYMMDDHHMMSS`(归档目录命名用,人一眼能看出是哪天搬的)。 */
471
+ export function formatStamp(now) {
472
+ const date = new Date(now);
473
+ const pad = (value) => String(value).padStart(2, '0');
474
+ return (`${String(date.getFullYear())}${pad(date.getMonth() + 1)}${pad(date.getDate())}` +
475
+ `${pad(date.getHours())}${pad(date.getMinutes())}${pad(date.getSeconds())}`);
476
+ }
477
+ /** 把一个技能目录搬进归档区。 */
478
+ export function moveToArchive(name, now = Date.now(), suffix = '') {
479
+ const dir = skillDirOf(name);
480
+ if (!existsSync(dir))
481
+ return { ok: false, error: `技能 ${name} 不存在`, path: '' };
482
+ const base = `${name}-${formatStamp(now)}${suffix}`;
483
+ let target = join(archiveRoot(), base);
484
+ for (let index = 1; existsSync(target) && index < 50; index += 1) {
485
+ target = join(archiveRoot(), `${base}-${String(index)}`);
486
+ }
487
+ try {
488
+ mkdirSync(archiveRoot(), { recursive: true });
489
+ renameSync(dir, target);
490
+ }
491
+ catch (error) {
492
+ return { ok: false, error: `搬进归档区失败:${errText(error)}`, path: '' };
493
+ }
494
+ return { ok: true, error: '', path: target };
495
+ }
496
+ /** 归档一个技能:只搬不删,台账里记一条。 */
497
+ export function archiveSkill(name, actor, note = '归档(只搬不删)', now = Date.now()) {
498
+ const file = skillFileOf(name);
499
+ if (!existsSync(file))
500
+ return fail(`技能 ${name} 不存在:没有可归档的东西`);
501
+ const beforeHash = hashText(readFileSync(file, 'utf8'));
502
+ const moved = moveToArchive(name, now);
503
+ if (!moved.ok)
504
+ return fail(moved.error);
505
+ return finishWrite({ actor, action: 'archive', skill: name, beforeHash, afterHash: EMPTY_HASH, note: `${note} → ${moved.path}` }, `已把技能 ${name} 搬进归档区 ${moved.path}(只搬不删,要恢复就把它搬回 ${skillsRoot()})`, '');
506
+ }
507
+ // ── read-before-write:本会话读过哪些技能 ────────────────────────────────────────
508
+ /** 扫会话消息里 `skill` 工具的调用参数,得到本会话读过的技能名。 */
509
+ export function skillNamesReadInMessages(messages) {
510
+ const names = new Set();
511
+ for (const message of messages) {
512
+ if (message.role !== 'assistant' || message.tool_calls === undefined)
513
+ continue;
514
+ for (const call of message.tool_calls) {
515
+ if (call.function.name !== 'skill')
516
+ continue;
517
+ try {
518
+ const args = JSON.parse(call.function.arguments);
519
+ if (typeof args.name === 'string' && args.name.trim() !== '')
520
+ names.add(args.name.trim());
521
+ }
522
+ catch {
523
+ // 参数不是合法 JSON 的调用跳过:这条调用本身也没成功
524
+ }
525
+ }
526
+ }
527
+ return [...names];
528
+ }
529
+ /**
530
+ * read-before-write:本会话必须读过这个技能才准改。
531
+ *
532
+ * 为什么要查会话消息而不是只信会话状态:状态是插件自己写的,模型看不到也改不了,
533
+ * 但「读过」这个事实本来就在会话里(`skill` 工具的调用参数)。两边取并集,
534
+ * 重启恢复的老会话也能认出「这个会话确实读过它」。
535
+ */
536
+ export function readBeforeWriteCheck(input) {
537
+ if (input.createdSkills.includes(input.name))
538
+ return { ok: true, error: '' };
539
+ if (input.readSkills.includes(input.name))
540
+ return { ok: true, error: '' };
541
+ if (skillNamesReadInMessages(input.messages).includes(input.name))
542
+ return { ok: true, error: '' };
543
+ return { ok: false, error: `改 ${input.name} 之前得先读它:本会话还没用 skill 工具读过这个技能,先读一遍再改` };
544
+ }
545
+ /** 从会话消息里取出最后一条用户消息的纯文本(L1 的纠正语气判定用)。 */
546
+ export function lastUserText(messages) {
547
+ for (let index = messages.length - 1; index >= 0; index -= 1) {
548
+ const message = messages[index];
549
+ if (message !== undefined && message.role === 'user')
550
+ return contentText(message.content).trim();
551
+ }
552
+ return '';
553
+ }
554
+ /** 最后一个用户消息之前那条用户消息(L1 记「上一轮用户说了什么」用)。 */
555
+ export function previousUserText(messages) {
556
+ let seen = 0;
557
+ for (let index = messages.length - 1; index >= 0; index -= 1) {
558
+ const message = messages[index];
559
+ if (message === undefined || message.role !== 'user')
560
+ continue;
561
+ seen += 1;
562
+ if (seen === 2)
563
+ return contentText(message.content).trim();
564
+ }
565
+ return '';
566
+ }
567
+ /** 本轮用了多少次工具迭代(从末尾往回数 tool 消息,遇到 user 消息停)。 */
568
+ export function toolIterationsOfTurn(messages) {
569
+ let count = 0;
570
+ for (let index = messages.length - 1; index >= 0; index -= 1) {
571
+ const message = messages[index];
572
+ if (message === undefined)
573
+ continue;
574
+ if (message.role === 'user')
575
+ break;
576
+ if (message.role === 'tool')
577
+ count += 1;
578
+ }
579
+ return count;
580
+ }
581
+ /** 本轮用户消息是第几条(0 起算;没有用户消息返回 -1)。 */
582
+ export function userTurnIndex(messages) {
583
+ let count = 0;
584
+ for (const message of messages)
585
+ if (message.role === 'user')
586
+ count += 1;
587
+ return count - 1;
588
+ }
589
+ /** 取最后一条 assistant 消息的正文(L2 复盘结果就是这一条)。 */
590
+ export function lastAssistantText(messages) {
591
+ for (let index = messages.length - 1; index >= 0; index -= 1) {
592
+ const message = messages[index];
593
+ if (message !== undefined && message.role === 'assistant')
594
+ return contentText(message.content).trim();
595
+ }
596
+ return '';
597
+ }
598
+ /** 读使用台账;文件缺失或坏了都当空台账(它只是遥测,不该让技能功能瘫掉)。 */
599
+ export function readUsage() {
600
+ const file = usageFile();
601
+ if (!existsSync(file))
602
+ return { version: 1, skills: {} };
603
+ try {
604
+ const raw = JSON.parse(readFileSync(file, 'utf8'));
605
+ const skills = {};
606
+ if (raw.skills !== null && typeof raw.skills === 'object' && !Array.isArray(raw.skills)) {
607
+ for (const [name, value] of Object.entries(raw.skills)) {
608
+ if (value === null || typeof value !== 'object' || Array.isArray(value))
609
+ continue;
610
+ const record = value;
611
+ const num = (field, fallback) => {
612
+ const parsed = Number(field);
613
+ return Number.isFinite(parsed) ? Math.trunc(parsed) : fallback;
614
+ };
615
+ const time = (field) => {
616
+ const parsed = Number(field);
617
+ return Number.isFinite(parsed) && parsed > 0 ? Math.trunc(parsed) : null;
618
+ };
619
+ const state = record.state;
620
+ skills[name] = {
621
+ createdBy: typeof record.createdBy === 'string' ? record.createdBy : 'user',
622
+ useCount: num(record.useCount, 0),
623
+ patchCount: num(record.patchCount, 0),
624
+ createdAt: num(record.createdAt, 0),
625
+ lastUsedAt: time(record.lastUsedAt),
626
+ lastPatchedAt: time(record.lastPatchedAt),
627
+ state: state === 'stale' || state === 'archived' ? state : 'active',
628
+ pinned: record.pinned === true,
629
+ archivedAt: time(record.archivedAt),
630
+ };
631
+ }
632
+ }
633
+ return { version: 1, skills };
634
+ }
635
+ catch {
636
+ return { version: 1, skills: {} };
637
+ }
638
+ }
639
+ /** 写使用台账(tmp + rename)。 */
640
+ export function writeUsage(doc) {
641
+ const file = usageFile();
642
+ mkdirSync(dirname(file), { recursive: true });
643
+ const tmp = `${file}.tmp`;
644
+ writeFileSync(tmp, `${JSON.stringify(doc, null, 2)}\n`, 'utf8');
645
+ try {
646
+ renameSync(tmp, file);
647
+ }
648
+ catch (error) {
649
+ try {
650
+ unlinkSync(tmp);
651
+ }
652
+ catch {
653
+ // 忽略
654
+ }
655
+ throw error;
656
+ }
657
+ }
658
+ /** 拿一条记录(没有就现造一条,不落盘)。 */
659
+ function ensureRecord(doc, name, now) {
660
+ const existing = doc.skills[name];
661
+ if (existing !== undefined)
662
+ return existing;
663
+ const fresh = {
664
+ createdBy: 'user',
665
+ useCount: 0,
666
+ patchCount: 0,
667
+ createdAt: now,
668
+ lastUsedAt: null,
669
+ lastPatchedAt: null,
670
+ state: 'active',
671
+ pinned: false,
672
+ archivedAt: null,
673
+ };
674
+ doc.skills[name] = fresh;
675
+ return fresh;
676
+ }
677
+ /** 记一次命中(`skill` 工具把它读出来了):stale 的重新变 active。 */
678
+ export function bumpSkillUse(name, now = Date.now()) {
679
+ try {
680
+ const doc = readUsage();
681
+ const record = ensureRecord(doc, name, now);
682
+ record.useCount += 1;
683
+ record.lastUsedAt = now;
684
+ if (record.state === 'stale')
685
+ record.state = 'active';
686
+ writeUsage(doc);
687
+ }
688
+ catch {
689
+ // 遥测写不进去不影响技能本身
690
+ }
691
+ }
692
+ /** 记一次改动(patch / write_file)。 */
693
+ export function bumpSkillPatch(name, now = Date.now()) {
694
+ try {
695
+ const doc = readUsage();
696
+ const record = ensureRecord(doc, name, now);
697
+ record.patchCount += 1;
698
+ record.lastPatchedAt = now;
699
+ if (record.state === 'stale')
700
+ record.state = 'active';
701
+ writeUsage(doc);
702
+ }
703
+ catch {
704
+ // 同上
705
+ }
706
+ }
707
+ /** 新建技能时起一条记录:`createdBy: agent` 是「允许自动化维护它」的唯一凭据。 */
708
+ export function recordSkillCreated(name, now = Date.now(), createdBy = 'agent') {
709
+ try {
710
+ const doc = readUsage();
711
+ doc.skills[name] = {
712
+ createdBy,
713
+ useCount: 0,
714
+ patchCount: 0,
715
+ createdAt: now,
716
+ lastUsedAt: null,
717
+ lastPatchedAt: null,
718
+ state: 'active',
719
+ pinned: false,
720
+ archivedAt: null,
721
+ };
722
+ writeUsage(doc);
723
+ }
724
+ catch {
725
+ // 同上
726
+ }
727
+ }
728
+ /** 钉住 / 取消钉住;返回钉住后的状态。 */
729
+ export function setSkillPinned(name, pinned, now = Date.now()) {
730
+ const doc = readUsage();
731
+ ensureRecord(doc, name, now).pinned = pinned;
732
+ writeUsage(doc);
733
+ return pinned;
734
+ }
735
+ /** 这个技能被钉住了吗。 */
736
+ export function isSkillPinned(name) {
737
+ return readUsage().skills[name]?.pinned === true;
738
+ }
739
+ export const DEFAULT_AGING = { staleAfterDays: 14, archiveAfterDays: 30 };
740
+ /**
741
+ * 一条记录现在该是什么档:活跃时间取「最后一次被读 / 被改 / 创建」里最新的那个。
742
+ *
743
+ * 为什么把 patch 也算活跃:被改过说明它还在被维护,用「最近一次命中」单算会把
744
+ * 一个正在被反复改的技能判成 stale。
745
+ */
746
+ export function classifyAging(record, now, options = DEFAULT_AGING) {
747
+ const anchor = Math.max(record.lastUsedAt ?? 0, record.lastPatchedAt ?? 0, record.createdAt);
748
+ const days = (now - anchor) / (24 * 60 * 60 * 1000);
749
+ if (days >= options.archiveAfterDays)
750
+ return 'archived';
751
+ if (days >= options.staleAfterDays)
752
+ return 'stale';
753
+ return 'active';
754
+ }
755
+ /**
756
+ * 整理一次:把久未命中的技能降级,把过期的搬进归档区。
757
+ *
758
+ * **只动 `createdBy: 'agent'` 的技能**(与 hermes 的 curator 同一条规矩):用户手写的技能
759
+ * 是用户的东西,自动化没有资格替他把目录搬走。钉住的技能一律跳过。
760
+ */
761
+ export function curateSkills(now = Date.now(), options = DEFAULT_AGING) {
762
+ const report = { stale: [], archived: [], skipped: [], total: 0 };
763
+ const doc = readUsage();
764
+ let local = [];
765
+ try {
766
+ local = scanSkillRoot({ dir: skillsRoot(), source: 'user-dsc', rank: 400 }).map((item) => item.name);
767
+ }
768
+ catch {
769
+ local = [];
770
+ }
771
+ report.total = local.length;
772
+ for (const name of local) {
773
+ const record = doc.skills[name];
774
+ if (record === undefined) {
775
+ // 第一次见到的技能:起一条记录把活跃时钟锚在现在,绝不在这一轮就判它过期
776
+ ensureRecord(doc, name, now);
777
+ report.skipped.push(name);
778
+ continue;
779
+ }
780
+ if (record.pinned) {
781
+ report.skipped.push(name);
782
+ continue;
783
+ }
784
+ if (record.createdBy !== 'agent') {
785
+ report.skipped.push(name);
786
+ continue;
787
+ }
788
+ if (record.state === 'archived') {
789
+ report.skipped.push(name);
790
+ continue;
791
+ }
792
+ const next = classifyAging(record, now, options);
793
+ if (next === 'active') {
794
+ if (record.state === 'stale')
795
+ record.state = 'active';
796
+ report.skipped.push(name);
797
+ continue;
798
+ }
799
+ if (next === 'stale') {
800
+ record.state = 'stale';
801
+ report.stale.push(name);
802
+ continue;
803
+ }
804
+ const moved = moveToArchive(name, now);
805
+ if (!moved.ok) {
806
+ report.skipped.push(name);
807
+ continue;
808
+ }
809
+ record.state = 'archived';
810
+ record.archivedAt = now;
811
+ report.archived.push(name);
812
+ try {
813
+ appendLedger({
814
+ actor: 'user',
815
+ action: 'archive',
816
+ skill: name,
817
+ beforeHash: EMPTY_HASH,
818
+ afterHash: EMPTY_HASH,
819
+ note: `老化归档:${String(options.archiveAfterDays)} 天没命中 → ${moved.path}`,
820
+ ts: now,
821
+ });
822
+ }
823
+ catch {
824
+ // 台账写不进去不影响已经搬走的事实
825
+ }
826
+ }
827
+ try {
828
+ writeUsage(doc);
829
+ }
830
+ catch {
831
+ // 台账写不进去就算了
832
+ }
833
+ return report;
834
+ }
835
+ /** 技能目录里有哪些本地技能(整理与设置页显示用)。 */
836
+ export function localSkillNames() {
837
+ try {
838
+ return scanSkillRoot({ dir: skillsRoot(), source: 'user-dsc', rank: 400 })
839
+ .map((item) => item.name)
840
+ .sort((a, b) => a.localeCompare(b));
841
+ }
842
+ catch {
843
+ return [];
844
+ }
845
+ }
846
+ /** 归档区里堆了多少个(设置页显示「只搬不删」的现状)。 */
847
+ export function archivedCount() {
848
+ try {
849
+ return existsSync(archiveRoot()) ? readdirSync(archiveRoot()).length : 0;
850
+ }
851
+ catch {
852
+ return 0;
853
+ }
854
+ }