@draht/coding-agent 2026.7.30 → 2026.10.4-2

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 (1229) hide show
  1. package/CHANGELOG.md +606 -0
  2. package/README.md +46 -2
  3. package/agents/debugger.md +12 -1
  4. package/agents/git-committer.md +1 -0
  5. package/agents/implementer.md +20 -0
  6. package/agents/investigator.md +75 -0
  7. package/agents/reviewer.md +7 -0
  8. package/agents/spec-reviewer.md +66 -0
  9. package/agents/verifier.md +4 -3
  10. package/bin/draht-tools.cjs +472 -41
  11. package/dist/agents/debugger.md +12 -1
  12. package/dist/agents/git-committer.md +1 -0
  13. package/dist/agents/implementer.md +20 -0
  14. package/dist/agents/investigator.md +75 -0
  15. package/dist/agents/reviewer.md +7 -0
  16. package/dist/agents/spec-reviewer.md +66 -0
  17. package/dist/agents/verifier.md +4 -3
  18. package/dist/bun/cli.d.ts +1 -1
  19. package/dist/bun/cli.d.ts.map +1 -1
  20. package/dist/bun/cli.js +6 -3
  21. package/dist/bun/cli.js.map +1 -1
  22. package/dist/bun/sandbox-env-setup.d.ts +2 -0
  23. package/dist/bun/sandbox-env-setup.d.ts.map +1 -0
  24. package/dist/bun/sandbox-env-setup.js +4 -0
  25. package/dist/bun/sandbox-env-setup.js.map +1 -0
  26. package/dist/bundle/chunks/anthropic-messages-GAKYXF65.js +6 -0
  27. package/dist/bundle/chunks/anthropic.js +75 -0
  28. package/dist/bundle/chunks/azure-openai-responses-ZIXMK6JO.js +2 -0
  29. package/dist/bundle/chunks/bedrock-converse-stream.js +79 -0
  30. package/dist/bundle/chunks/chunk-2E5VODES.js +2 -0
  31. package/dist/bundle/chunks/chunk-2FBJKY7F.js +2 -0
  32. package/dist/bundle/chunks/chunk-2N4I6WXC.js +2 -0
  33. package/dist/bundle/chunks/chunk-5VZWYVZB.js +82 -0
  34. package/dist/bundle/chunks/chunk-63BK6WK2.js +2 -0
  35. package/dist/bundle/chunks/chunk-6MSE6LZ3.js +6 -0
  36. package/dist/bundle/chunks/chunk-6ZJKIMU7.js +2 -0
  37. package/dist/bundle/chunks/chunk-736QBNUZ.js +12 -0
  38. package/dist/bundle/chunks/chunk-BXSHCX3G.js +11 -0
  39. package/dist/bundle/chunks/chunk-CEJJ5XF2.js +170 -0
  40. package/dist/bundle/chunks/chunk-COF5JT7R.js +4 -0
  41. package/dist/bundle/chunks/chunk-D6TMD5Q2.js +44 -0
  42. package/dist/bundle/chunks/chunk-DPE4ALPU.js +146 -0
  43. package/dist/bundle/chunks/chunk-EBVYI75P.js +2 -0
  44. package/dist/bundle/chunks/chunk-GVXA72ZA.js +2 -0
  45. package/dist/bundle/chunks/chunk-H6FT43VC.js +137 -0
  46. package/dist/bundle/chunks/chunk-HJ72RANT.js +2 -0
  47. package/dist/bundle/chunks/chunk-HTJ3L72O.js +2 -0
  48. package/dist/bundle/chunks/chunk-HZ2UHMBT.js +2 -0
  49. package/dist/bundle/chunks/chunk-I5OKY6RH.js +11 -0
  50. package/dist/bundle/chunks/chunk-IWTUBX6V.js +4 -0
  51. package/dist/bundle/chunks/chunk-KPO5375S.js +2 -0
  52. package/dist/bundle/chunks/chunk-KVH4HR57.js +31 -0
  53. package/dist/bundle/chunks/chunk-LDAOC5RB.js +18 -0
  54. package/dist/bundle/chunks/chunk-ON6XU6AG.js +2 -0
  55. package/dist/bundle/chunks/chunk-QMN7OD6G.js +2 -0
  56. package/dist/bundle/chunks/chunk-RZKPFWMH.js +42 -0
  57. package/dist/bundle/chunks/chunk-SDRCE6OP.js +2 -0
  58. package/dist/bundle/chunks/chunk-SVNWI7EV.js +8 -0
  59. package/dist/bundle/chunks/chunk-TIA2T6EO.js +3 -0
  60. package/dist/bundle/chunks/chunk-VOFPZOUQ.js +1472 -0
  61. package/dist/bundle/chunks/chunk-XBUEMKIY.js +2 -0
  62. package/dist/bundle/chunks/chunk-XOGEYN4Q.js +2 -0
  63. package/dist/bundle/chunks/chunk-ZZD35WKM.js +2 -0
  64. package/dist/bundle/chunks/cli-SR5QBZH4.js +51 -0
  65. package/dist/bundle/chunks/cloudflare-workers-ai-system-one-MJKOAE5S.js +2 -0
  66. package/dist/bundle/chunks/codemode-worker.js +315 -0
  67. package/dist/bundle/chunks/execute-VCYDHEYA.js +328 -0
  68. package/dist/bundle/chunks/github-copilot.js +2 -0
  69. package/dist/bundle/chunks/google-antigravity.js +75 -0
  70. package/dist/bundle/chunks/google-gemini-cli.js +75 -0
  71. package/dist/bundle/chunks/google-generative-ai-RPUPQ6PM.js +2 -0
  72. package/dist/bundle/chunks/google-vertex-EZES5QVQ.js +2 -0
  73. package/dist/bundle/chunks/https-proxy-agent-O2PVUIOI.js +13 -0
  74. package/dist/bundle/chunks/image-resize-worker.js +2 -0
  75. package/dist/bundle/chunks/jiti-loader-RKXLMQV2.js +2 -0
  76. package/dist/bundle/chunks/kimi-coding.js +2 -0
  77. package/dist/bundle/chunks/lib-XOG5PI3Y.js +9 -0
  78. package/dist/bundle/chunks/llama-cpp-classify-EJ5XMSQL.js +22 -0
  79. package/dist/bundle/chunks/meta.js +2 -0
  80. package/dist/bundle/chunks/mistral-conversations-AOYGU43Y.js +5 -0
  81. package/dist/bundle/chunks/multipart-parser-AZP5BX2W.js +3 -0
  82. package/dist/bundle/chunks/node-C2JGH2OB.js +2 -0
  83. package/dist/bundle/chunks/node-LQ52KV6B.js +16 -0
  84. package/dist/bundle/chunks/openai-chatgpt.js +75 -0
  85. package/dist/bundle/chunks/openai-codex-responses-M2Y77JEQ.js +10 -0
  86. package/dist/bundle/chunks/openai-codex.js +75 -0
  87. package/dist/bundle/chunks/openai-completions-A4OKYOYV.js +7 -0
  88. package/dist/bundle/chunks/openai-responses-6IXV53T3.js +3 -0
  89. package/dist/bundle/chunks/opencode-go.js +2 -0
  90. package/dist/bundle/chunks/openrouter-images-LYV4NKFM.js +2 -0
  91. package/dist/bundle/chunks/openrouter.js +75 -0
  92. package/dist/bundle/chunks/pi-messages-KKMEUT3Z.js +8 -0
  93. package/dist/bundle/chunks/radius.js +75 -0
  94. package/dist/bundle/chunks/runtime-6YJPGSP7.js +2 -0
  95. package/dist/bundle/chunks/settings-manager-D2EG7WDO.js +2 -0
  96. package/dist/bundle/chunks/src-TIBHS42X.js +4 -0
  97. package/dist/bundle/chunks/typesafe-system-one-YBEEY5XU.js +2 -0
  98. package/dist/bundle/chunks/virtual-modules-CBOAFAFT.js +2 -0
  99. package/dist/bundle/chunks/xai.js +75 -0
  100. package/dist/bundle/cli-runtime.js +3 -0
  101. package/dist/bundle/cli.js +5 -0
  102. package/dist/bundle/index.js +2 -0
  103. package/dist/bundle/rpc-entry.js +3 -0
  104. package/dist/cli/args.d.ts +14 -0
  105. package/dist/cli/args.d.ts.map +1 -1
  106. package/dist/cli/args.js +140 -22
  107. package/dist/cli/args.js.map +1 -1
  108. package/dist/cli/attach-mode.d.ts +61 -0
  109. package/dist/cli/attach-mode.d.ts.map +1 -1
  110. package/dist/cli/attach-mode.js +243 -5
  111. package/dist/cli/attach-mode.js.map +1 -1
  112. package/dist/cli/auth-check.d.ts +19 -0
  113. package/dist/cli/auth-check.d.ts.map +1 -0
  114. package/dist/cli/auth-check.js +50 -0
  115. package/dist/cli/auth-check.js.map +1 -0
  116. package/dist/cli/auth-command.d.ts +24 -0
  117. package/dist/cli/auth-command.d.ts.map +1 -0
  118. package/dist/cli/auth-command.js +103 -0
  119. package/dist/cli/auth-command.js.map +1 -0
  120. package/dist/cli/config-selector.d.ts.map +1 -1
  121. package/dist/cli/config-selector.js +3 -2
  122. package/dist/cli/config-selector.js.map +1 -1
  123. package/dist/cli/credential-print.d.ts +6 -4
  124. package/dist/cli/credential-print.d.ts.map +1 -1
  125. package/dist/cli/credential-print.js +47 -34
  126. package/dist/cli/credential-print.js.map +1 -1
  127. package/dist/cli/file-processor.d.ts +1 -1
  128. package/dist/cli/file-processor.d.ts.map +1 -1
  129. package/dist/cli/file-processor.js +2 -1
  130. package/dist/cli/file-processor.js.map +1 -1
  131. package/dist/cli/list-models.d.ts +1 -1
  132. package/dist/cli/list-models.d.ts.map +1 -1
  133. package/dist/cli/list-models.js +2 -2
  134. package/dist/cli/list-models.js.map +1 -1
  135. package/dist/cli/session-picker.d.ts +1 -1
  136. package/dist/cli/session-picker.d.ts.map +1 -1
  137. package/dist/cli/session-picker.js.map +1 -1
  138. package/dist/cli/setup.d.ts +2 -0
  139. package/dist/cli/setup.d.ts.map +1 -0
  140. package/dist/cli/setup.js +12 -0
  141. package/dist/cli/setup.js.map +1 -0
  142. package/dist/cli/startup-ui.d.ts +2 -2
  143. package/dist/cli/startup-ui.d.ts.map +1 -1
  144. package/dist/cli/startup-ui.js +42 -33
  145. package/dist/cli/startup-ui.js.map +1 -1
  146. package/dist/cli.js +3 -12
  147. package/dist/cli.js.map +1 -1
  148. package/dist/config.d.ts +29 -4
  149. package/dist/config.d.ts.map +1 -1
  150. package/dist/config.js +73 -10
  151. package/dist/config.js.map +1 -1
  152. package/dist/core/agent-session-runtime.d.ts +17 -1
  153. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  154. package/dist/core/agent-session-runtime.js +98 -32
  155. package/dist/core/agent-session-runtime.js.map +1 -1
  156. package/dist/core/agent-session-services.d.ts +2 -1
  157. package/dist/core/agent-session-services.d.ts.map +1 -1
  158. package/dist/core/agent-session-services.js +15 -0
  159. package/dist/core/agent-session-services.js.map +1 -1
  160. package/dist/core/agent-session.d.ts +266 -49
  161. package/dist/core/agent-session.d.ts.map +1 -1
  162. package/dist/core/agent-session.js +1503 -597
  163. package/dist/core/agent-session.js.map +1 -1
  164. package/dist/core/auth-storage.d.ts +25 -9
  165. package/dist/core/auth-storage.d.ts.map +1 -1
  166. package/dist/core/auth-storage.js +245 -45
  167. package/dist/core/auth-storage.js.map +1 -1
  168. package/dist/core/bug-report-upload.d.ts +11 -0
  169. package/dist/core/bug-report-upload.d.ts.map +1 -0
  170. package/dist/core/bug-report-upload.js +20 -0
  171. package/dist/core/bug-report-upload.js.map +1 -0
  172. package/dist/core/bug-report.d.ts +176 -0
  173. package/dist/core/bug-report.d.ts.map +1 -0
  174. package/dist/core/bug-report.js +292 -0
  175. package/dist/core/bug-report.js.map +1 -0
  176. package/dist/core/builtins/checkpoints.d.ts +20 -0
  177. package/dist/core/builtins/checkpoints.d.ts.map +1 -0
  178. package/dist/core/builtins/checkpoints.js +161 -0
  179. package/dist/core/builtins/checkpoints.js.map +1 -0
  180. package/dist/core/builtins/duet.d.ts +26 -0
  181. package/dist/core/builtins/duet.d.ts.map +1 -0
  182. package/dist/core/builtins/duet.js +660 -0
  183. package/dist/core/builtins/duet.js.map +1 -0
  184. package/dist/core/builtins/index.d.ts.map +1 -1
  185. package/dist/core/builtins/index.js +7 -1
  186. package/dist/core/builtins/index.js.map +1 -1
  187. package/dist/core/builtins/subagent.d.ts +24 -4
  188. package/dist/core/builtins/subagent.d.ts.map +1 -1
  189. package/dist/core/builtins/subagent.js +278 -35
  190. package/dist/core/builtins/subagent.js.map +1 -1
  191. package/dist/core/cache-stats.d.ts.map +1 -1
  192. package/dist/core/cache-stats.js +12 -1
  193. package/dist/core/cache-stats.js.map +1 -1
  194. package/dist/core/cache-warmer.d.ts +103 -0
  195. package/dist/core/cache-warmer.d.ts.map +1 -0
  196. package/dist/core/cache-warmer.js +356 -0
  197. package/dist/core/cache-warmer.js.map +1 -0
  198. package/dist/core/checkpoints/checkpoint-cli.d.ts +17 -0
  199. package/dist/core/checkpoints/checkpoint-cli.d.ts.map +1 -0
  200. package/dist/core/checkpoints/checkpoint-cli.js +78 -0
  201. package/dist/core/checkpoints/checkpoint-cli.js.map +1 -0
  202. package/dist/core/checkpoints/checkpoint-manager.d.ts +298 -0
  203. package/dist/core/checkpoints/checkpoint-manager.d.ts.map +1 -0
  204. package/dist/core/checkpoints/checkpoint-manager.js +901 -0
  205. package/dist/core/checkpoints/checkpoint-manager.js.map +1 -0
  206. package/dist/core/checkpoints/rewind.d.ts +143 -0
  207. package/dist/core/checkpoints/rewind.d.ts.map +1 -0
  208. package/dist/core/checkpoints/rewind.js +247 -0
  209. package/dist/core/checkpoints/rewind.js.map +1 -0
  210. package/dist/core/compaction/branch-summarization.d.ts +1 -1
  211. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  212. package/dist/core/compaction/branch-summarization.js +11 -6
  213. package/dist/core/compaction/branch-summarization.js.map +1 -1
  214. package/dist/core/compaction/compaction.d.ts +14 -6
  215. package/dist/core/compaction/compaction.d.ts.map +1 -1
  216. package/dist/core/compaction/compaction.js +221 -122
  217. package/dist/core/compaction/compaction.js.map +1 -1
  218. package/dist/core/compaction/utils.d.ts +2 -1
  219. package/dist/core/compaction/utils.d.ts.map +1 -1
  220. package/dist/core/compaction/utils.js +25 -18
  221. package/dist/core/compaction/utils.js.map +1 -1
  222. package/dist/core/crash-log.d.ts +27 -0
  223. package/dist/core/crash-log.d.ts.map +1 -0
  224. package/dist/core/crash-log.js +140 -0
  225. package/dist/core/crash-log.js.map +1 -0
  226. package/dist/core/defaults.d.ts +1 -0
  227. package/dist/core/defaults.d.ts.map +1 -1
  228. package/dist/core/defaults.js +9 -0
  229. package/dist/core/defaults.js.map +1 -1
  230. package/dist/core/experimental.js +1 -1
  231. package/dist/core/experimental.js.map +1 -1
  232. package/dist/core/export-html/template.css +10 -0
  233. package/dist/core/export-html/template.js +72 -18
  234. package/dist/core/extensions/index.d.ts +2 -2
  235. package/dist/core/extensions/index.d.ts.map +1 -1
  236. package/dist/core/extensions/index.js +1 -1
  237. package/dist/core/extensions/index.js.map +1 -1
  238. package/dist/core/extensions/jiti-loader.d.ts +2 -0
  239. package/dist/core/extensions/jiti-loader.d.ts.map +1 -0
  240. package/dist/core/extensions/jiti-loader.js +5 -0
  241. package/dist/core/extensions/jiti-loader.js.map +1 -0
  242. package/dist/core/extensions/loader.d.ts.map +1 -1
  243. package/dist/core/extensions/loader.js +298 -96
  244. package/dist/core/extensions/loader.js.map +1 -1
  245. package/dist/core/extensions/runner.d.ts +59 -9
  246. package/dist/core/extensions/runner.d.ts.map +1 -1
  247. package/dist/core/extensions/runner.js +410 -103
  248. package/dist/core/extensions/runner.js.map +1 -1
  249. package/dist/core/extensions/types.d.ts +701 -85
  250. package/dist/core/extensions/types.d.ts.map +1 -1
  251. package/dist/core/extensions/types.js +3 -0
  252. package/dist/core/extensions/types.js.map +1 -1
  253. package/dist/core/extensions/virtual-modules.d.ts +3 -0
  254. package/dist/core/extensions/virtual-modules.d.ts.map +1 -0
  255. package/dist/core/extensions/virtual-modules.js +37 -0
  256. package/dist/core/extensions/virtual-modules.js.map +1 -0
  257. package/dist/core/extensions/wrapper.d.ts +2 -2
  258. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  259. package/dist/core/extensions/wrapper.js +3 -22
  260. package/dist/core/extensions/wrapper.js.map +1 -1
  261. package/dist/core/footer-data-provider.d.ts +1 -1
  262. package/dist/core/footer-data-provider.js +19 -18
  263. package/dist/core/footer-data-provider.js.map +1 -1
  264. package/dist/core/http-dispatcher.d.ts.map +1 -1
  265. package/dist/core/http-dispatcher.js +7 -0
  266. package/dist/core/http-dispatcher.js.map +1 -1
  267. package/dist/core/index.d.ts +2 -1
  268. package/dist/core/index.d.ts.map +1 -1
  269. package/dist/core/index.js.map +1 -1
  270. package/dist/core/keybindings.d.ts +88 -13
  271. package/dist/core/keybindings.d.ts.map +1 -1
  272. package/dist/core/keybindings.js +34 -7
  273. package/dist/core/keybindings.js.map +1 -1
  274. package/dist/core/mcp-servers.d.ts +119 -0
  275. package/dist/core/mcp-servers.d.ts.map +1 -0
  276. package/dist/core/mcp-servers.js +191 -0
  277. package/dist/core/mcp-servers.js.map +1 -0
  278. package/dist/core/messages.d.ts +1 -1
  279. package/dist/core/messages.d.ts.map +1 -1
  280. package/dist/core/messages.js +1 -0
  281. package/dist/core/messages.js.map +1 -1
  282. package/dist/core/model-config.d.ts +202 -20
  283. package/dist/core/model-config.d.ts.map +1 -1
  284. package/dist/core/model-config.js +53 -18
  285. package/dist/core/model-config.js.map +1 -1
  286. package/dist/core/model-registry.d.ts +21 -3
  287. package/dist/core/model-registry.d.ts.map +1 -1
  288. package/dist/core/model-registry.js +47 -10
  289. package/dist/core/model-registry.js.map +1 -1
  290. package/dist/core/model-resolver.d.ts +7 -5
  291. package/dist/core/model-resolver.d.ts.map +1 -1
  292. package/dist/core/model-resolver.js +62 -23
  293. package/dist/core/model-resolver.js.map +1 -1
  294. package/dist/core/model-runtime.d.ts +80 -15
  295. package/dist/core/model-runtime.d.ts.map +1 -1
  296. package/dist/core/model-runtime.js +466 -120
  297. package/dist/core/model-runtime.js.map +1 -1
  298. package/dist/core/models-store.d.ts +12 -7
  299. package/dist/core/models-store.d.ts.map +1 -1
  300. package/dist/core/models-store.js +87 -18
  301. package/dist/core/models-store.js.map +1 -1
  302. package/dist/core/multi-agent/fsm.js +8 -3
  303. package/dist/core/multi-agent/fsm.js.map +1 -1
  304. package/dist/core/multi-agent/mailbox.js +1 -3
  305. package/dist/core/multi-agent/mailbox.js.map +1 -1
  306. package/dist/core/multi-agent/permission-gate.d.ts +5 -2
  307. package/dist/core/multi-agent/permission-gate.d.ts.map +1 -1
  308. package/dist/core/multi-agent/permission-gate.js +601 -37
  309. package/dist/core/multi-agent/permission-gate.js.map +1 -1
  310. package/dist/core/multi-agent/task-board.js +2 -4
  311. package/dist/core/multi-agent/task-board.js.map +1 -1
  312. package/dist/core/multi-agent/worktree.d.ts +2 -0
  313. package/dist/core/multi-agent/worktree.d.ts.map +1 -1
  314. package/dist/core/multi-agent/worktree.js +3 -5
  315. package/dist/core/multi-agent/worktree.js.map +1 -1
  316. package/dist/core/nested-tool-calls.d.ts +102 -0
  317. package/dist/core/nested-tool-calls.d.ts.map +1 -0
  318. package/dist/core/nested-tool-calls.js +178 -0
  319. package/dist/core/nested-tool-calls.js.map +1 -0
  320. package/dist/core/package-manager.d.ts +16 -0
  321. package/dist/core/package-manager.d.ts.map +1 -1
  322. package/dist/core/package-manager.js +162 -69
  323. package/dist/core/package-manager.js.map +1 -1
  324. package/dist/core/permission-relay/index.d.ts +19 -0
  325. package/dist/core/permission-relay/index.d.ts.map +1 -0
  326. package/dist/core/permission-relay/index.js +49 -0
  327. package/dist/core/permission-relay/index.js.map +1 -0
  328. package/dist/core/permission-relay/relay-ui-context.d.ts +39 -0
  329. package/dist/core/permission-relay/relay-ui-context.d.ts.map +1 -0
  330. package/dist/core/permission-relay/relay-ui-context.js +788 -0
  331. package/dist/core/permission-relay/relay-ui-context.js.map +1 -0
  332. package/dist/core/permission-relay/types.d.ts +222 -0
  333. package/dist/core/permission-relay/types.d.ts.map +1 -0
  334. package/dist/core/permission-relay/types.js +15 -0
  335. package/dist/core/permission-relay/types.js.map +1 -0
  336. package/dist/core/pi-manifest.d.ts +14 -0
  337. package/dist/core/pi-manifest.d.ts.map +1 -0
  338. package/dist/core/pi-manifest.js +36 -0
  339. package/dist/core/pi-manifest.js.map +1 -0
  340. package/dist/core/project-trust.js +2 -2
  341. package/dist/core/project-trust.js.map +1 -1
  342. package/dist/core/prompt-templates.d.ts +6 -1
  343. package/dist/core/prompt-templates.d.ts.map +1 -1
  344. package/dist/core/prompt-templates.js +63 -37
  345. package/dist/core/prompt-templates.js.map +1 -1
  346. package/dist/core/provider-attribution.js +5 -5
  347. package/dist/core/provider-attribution.js.map +1 -1
  348. package/dist/core/provider-composer.d.ts +44 -20
  349. package/dist/core/provider-composer.d.ts.map +1 -1
  350. package/dist/core/provider-composer.js +151 -51
  351. package/dist/core/provider-composer.js.map +1 -1
  352. package/dist/core/radius.d.ts +13 -0
  353. package/dist/core/radius.d.ts.map +1 -1
  354. package/dist/core/radius.js +19 -0
  355. package/dist/core/radius.js.map +1 -1
  356. package/dist/core/remote-catalog-provider.d.ts +10 -3
  357. package/dist/core/remote-catalog-provider.d.ts.map +1 -1
  358. package/dist/core/remote-catalog-provider.js +105 -81
  359. package/dist/core/remote-catalog-provider.js.map +1 -1
  360. package/dist/core/resource-loader.d.ts +28 -1
  361. package/dist/core/resource-loader.d.ts.map +1 -1
  362. package/dist/core/resource-loader.js +319 -65
  363. package/dist/core/resource-loader.js.map +1 -1
  364. package/dist/core/runtime-credentials.d.ts +5 -5
  365. package/dist/core/runtime-credentials.d.ts.map +1 -1
  366. package/dist/core/runtime-credentials.js +13 -9
  367. package/dist/core/runtime-credentials.js.map +1 -1
  368. package/dist/core/sandbox/bash-operations.d.ts +149 -0
  369. package/dist/core/sandbox/bash-operations.d.ts.map +1 -0
  370. package/dist/core/sandbox/bash-operations.js +163 -0
  371. package/dist/core/sandbox/bash-operations.js.map +1 -0
  372. package/dist/core/sandbox/env.d.ts +83 -0
  373. package/dist/core/sandbox/env.d.ts.map +1 -0
  374. package/dist/core/sandbox/env.js +123 -0
  375. package/dist/core/sandbox/env.js.map +1 -0
  376. package/dist/core/sandbox/executor.d.ts +104 -0
  377. package/dist/core/sandbox/executor.d.ts.map +1 -0
  378. package/dist/core/sandbox/executor.js +93 -0
  379. package/dist/core/sandbox/executor.js.map +1 -0
  380. package/dist/core/sandbox/index.d.ts +36 -0
  381. package/dist/core/sandbox/index.d.ts.map +1 -0
  382. package/dist/core/sandbox/index.js +36 -0
  383. package/dist/core/sandbox/index.js.map +1 -0
  384. package/dist/core/sandbox/linux.d.ts +121 -0
  385. package/dist/core/sandbox/linux.d.ts.map +1 -0
  386. package/dist/core/sandbox/linux.js +260 -0
  387. package/dist/core/sandbox/linux.js.map +1 -0
  388. package/dist/core/sandbox/policy.d.ts +142 -0
  389. package/dist/core/sandbox/policy.d.ts.map +1 -0
  390. package/dist/core/sandbox/policy.js +297 -0
  391. package/dist/core/sandbox/policy.js.map +1 -0
  392. package/dist/core/sandbox/real-path.d.ts +112 -0
  393. package/dist/core/sandbox/real-path.d.ts.map +1 -0
  394. package/dist/core/sandbox/real-path.js +158 -0
  395. package/dist/core/sandbox/real-path.js.map +1 -0
  396. package/dist/core/sandbox/seatbelt-profile.d.ts +95 -0
  397. package/dist/core/sandbox/seatbelt-profile.d.ts.map +1 -0
  398. package/dist/core/sandbox/seatbelt-profile.js +239 -0
  399. package/dist/core/sandbox/seatbelt-profile.js.map +1 -0
  400. package/dist/core/sandbox/seatbelt.d.ts +95 -0
  401. package/dist/core/sandbox/seatbelt.d.ts.map +1 -0
  402. package/dist/core/sandbox/seatbelt.js +154 -0
  403. package/dist/core/sandbox/seatbelt.js.map +1 -0
  404. package/dist/core/sandbox/self-test.d.ts +109 -0
  405. package/dist/core/sandbox/self-test.d.ts.map +1 -0
  406. package/dist/core/sandbox/self-test.js +369 -0
  407. package/dist/core/sandbox/self-test.js.map +1 -0
  408. package/dist/core/sandbox/spawn.d.ts +33 -0
  409. package/dist/core/sandbox/spawn.d.ts.map +1 -0
  410. package/dist/core/sandbox/spawn.js +87 -0
  411. package/dist/core/sandbox/spawn.js.map +1 -0
  412. package/dist/core/sdk.d.ts +7 -5
  413. package/dist/core/sdk.d.ts.map +1 -1
  414. package/dist/core/sdk.js +103 -53
  415. package/dist/core/sdk.js.map +1 -1
  416. package/dist/core/session-cwd.js +1 -0
  417. package/dist/core/session-cwd.js.map +1 -1
  418. package/dist/core/session-export.d.ts +8 -0
  419. package/dist/core/session-export.d.ts.map +1 -0
  420. package/dist/core/session-export.js +33 -0
  421. package/dist/core/session-export.js.map +1 -0
  422. package/dist/core/session-manager.d.ts +134 -15
  423. package/dist/core/session-manager.d.ts.map +1 -1
  424. package/dist/core/session-manager.js +366 -149
  425. package/dist/core/session-manager.js.map +1 -1
  426. package/dist/core/settings-diagnostics.d.ts +9 -0
  427. package/dist/core/settings-diagnostics.d.ts.map +1 -0
  428. package/dist/core/settings-diagnostics.js +21 -0
  429. package/dist/core/settings-diagnostics.js.map +1 -0
  430. package/dist/core/settings-manager.d.ts +105 -4
  431. package/dist/core/settings-manager.d.ts.map +1 -1
  432. package/dist/core/settings-manager.js +274 -40
  433. package/dist/core/settings-manager.js.map +1 -1
  434. package/dist/core/skills.d.ts +3 -1
  435. package/dist/core/skills.d.ts.map +1 -1
  436. package/dist/core/skills.js +70 -39
  437. package/dist/core/skills.js.map +1 -1
  438. package/dist/core/slash-commands.d.ts.map +1 -1
  439. package/dist/core/slash-commands.js +4 -1
  440. package/dist/core/slash-commands.js.map +1 -1
  441. package/dist/core/soak/soak-log.d.ts +298 -0
  442. package/dist/core/soak/soak-log.d.ts.map +1 -0
  443. package/dist/core/soak/soak-log.js +666 -0
  444. package/dist/core/soak/soak-log.js.map +1 -0
  445. package/dist/core/soak/soak-reader.d.ts +60 -0
  446. package/dist/core/soak/soak-reader.d.ts.map +1 -0
  447. package/dist/core/soak/soak-reader.js +106 -0
  448. package/dist/core/soak/soak-reader.js.map +1 -0
  449. package/dist/core/socket-server/discovery.d.ts +78 -1
  450. package/dist/core/socket-server/discovery.d.ts.map +1 -1
  451. package/dist/core/socket-server/discovery.js +356 -37
  452. package/dist/core/socket-server/discovery.js.map +1 -1
  453. package/dist/core/socket-server/index.d.ts +10 -4
  454. package/dist/core/socket-server/index.d.ts.map +1 -1
  455. package/dist/core/socket-server/index.js +6 -3
  456. package/dist/core/socket-server/index.js.map +1 -1
  457. package/dist/core/socket-server/permission-delivery.d.ts +125 -0
  458. package/dist/core/socket-server/permission-delivery.d.ts.map +1 -0
  459. package/dist/core/socket-server/permission-delivery.js +152 -0
  460. package/dist/core/socket-server/permission-delivery.js.map +1 -0
  461. package/dist/core/socket-server/permission-registry.d.ts +301 -0
  462. package/dist/core/socket-server/permission-registry.d.ts.map +1 -0
  463. package/dist/core/socket-server/permission-registry.js +410 -0
  464. package/dist/core/socket-server/permission-registry.js.map +1 -0
  465. package/dist/core/socket-server/permission-relay.d.ts +81 -0
  466. package/dist/core/socket-server/permission-relay.d.ts.map +1 -0
  467. package/dist/core/socket-server/permission-relay.js +528 -0
  468. package/dist/core/socket-server/permission-relay.js.map +1 -0
  469. package/dist/core/socket-server/safe-text.d.ts +83 -0
  470. package/dist/core/socket-server/safe-text.d.ts.map +1 -0
  471. package/dist/core/socket-server/safe-text.js +277 -0
  472. package/dist/core/socket-server/safe-text.js.map +1 -0
  473. package/dist/core/socket-server/session-integration.d.ts +65 -2
  474. package/dist/core/socket-server/session-integration.d.ts.map +1 -1
  475. package/dist/core/socket-server/session-integration.js +434 -32
  476. package/dist/core/socket-server/session-integration.js.map +1 -1
  477. package/dist/core/socket-server/socket-client.d.ts +21 -2
  478. package/dist/core/socket-server/socket-client.d.ts.map +1 -1
  479. package/dist/core/socket-server/socket-client.js +52 -1
  480. package/dist/core/socket-server/socket-client.js.map +1 -1
  481. package/dist/core/socket-server/socket-server.d.ts +152 -1
  482. package/dist/core/socket-server/socket-server.d.ts.map +1 -1
  483. package/dist/core/socket-server/socket-server.js +786 -26
  484. package/dist/core/socket-server/socket-server.js.map +1 -1
  485. package/dist/core/socket-server/types.d.ts +108 -3
  486. package/dist/core/socket-server/types.d.ts.map +1 -1
  487. package/dist/core/socket-server/types.js +13 -1
  488. package/dist/core/socket-server/types.js.map +1 -1
  489. package/dist/core/source-info.d.ts +8 -0
  490. package/dist/core/source-info.d.ts.map +1 -1
  491. package/dist/core/source-info.js +16 -0
  492. package/dist/core/source-info.js.map +1 -1
  493. package/dist/core/system-prompt.d.ts +49 -6
  494. package/dist/core/system-prompt.d.ts.map +1 -1
  495. package/dist/core/system-prompt.js +126 -90
  496. package/dist/core/system-prompt.js.map +1 -1
  497. package/dist/core/tools/bash.d.ts +32 -2
  498. package/dist/core/tools/bash.d.ts.map +1 -1
  499. package/dist/core/tools/bash.js +83 -141
  500. package/dist/core/tools/bash.js.map +1 -1
  501. package/dist/core/tools/edit-diff.d.ts +0 -5
  502. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  503. package/dist/core/tools/edit-diff.js +2 -5
  504. package/dist/core/tools/edit-diff.js.map +1 -1
  505. package/dist/core/tools/edit.d.ts +5 -12
  506. package/dist/core/tools/edit.d.ts.map +1 -1
  507. package/dist/core/tools/edit.js +36 -173
  508. package/dist/core/tools/edit.js.map +1 -1
  509. package/dist/core/tools/find.d.ts +7 -0
  510. package/dist/core/tools/find.d.ts.map +1 -1
  511. package/dist/core/tools/find.js +22 -76
  512. package/dist/core/tools/find.js.map +1 -1
  513. package/dist/core/tools/grep.d.ts +4 -0
  514. package/dist/core/tools/grep.d.ts.map +1 -1
  515. package/dist/core/tools/grep.js +10 -62
  516. package/dist/core/tools/grep.js.map +1 -1
  517. package/dist/core/tools/index.d.ts +4 -1
  518. package/dist/core/tools/index.d.ts.map +1 -1
  519. package/dist/core/tools/index.js +18 -1
  520. package/dist/core/tools/index.js.map +1 -1
  521. package/dist/core/tools/ls.d.ts +4 -0
  522. package/dist/core/tools/ls.d.ts.map +1 -1
  523. package/dist/core/tools/ls.js +9 -50
  524. package/dist/core/tools/ls.js.map +1 -1
  525. package/dist/core/tools/output-accumulator.d.ts +11 -0
  526. package/dist/core/tools/output-accumulator.d.ts.map +1 -1
  527. package/dist/core/tools/output-accumulator.js +54 -12
  528. package/dist/core/tools/output-accumulator.js.map +1 -1
  529. package/dist/core/tools/powershell.d.ts +16 -0
  530. package/dist/core/tools/powershell.d.ts.map +1 -0
  531. package/dist/core/tools/powershell.js +39 -0
  532. package/dist/core/tools/powershell.js.map +1 -0
  533. package/dist/core/tools/read.d.ts +8 -1
  534. package/dist/core/tools/read.d.ts.map +1 -1
  535. package/dist/core/tools/read.js +16 -123
  536. package/dist/core/tools/read.js.map +1 -1
  537. package/dist/core/tools/render-utils.d.ts +6 -0
  538. package/dist/core/tools/render-utils.d.ts.map +1 -1
  539. package/dist/core/tools/render-utils.js +26 -0
  540. package/dist/core/tools/render-utils.js.map +1 -1
  541. package/dist/core/tools/renderers/bash.d.ts +12 -0
  542. package/dist/core/tools/renderers/bash.d.ts.map +1 -0
  543. package/dist/core/tools/renderers/bash.js +117 -0
  544. package/dist/core/tools/renderers/bash.js.map +1 -0
  545. package/dist/core/tools/renderers/edit.d.ts +23 -0
  546. package/dist/core/tools/renderers/edit.d.ts.map +1 -0
  547. package/dist/core/tools/renderers/edit.js +167 -0
  548. package/dist/core/tools/renderers/edit.js.map +1 -0
  549. package/dist/core/tools/renderers/find.d.ts +10 -0
  550. package/dist/core/tools/renderers/find.d.ts.map +1 -0
  551. package/dist/core/tools/renderers/find.js +64 -0
  552. package/dist/core/tools/renderers/find.js.map +1 -0
  553. package/dist/core/tools/renderers/grep.d.ts +10 -0
  554. package/dist/core/tools/renderers/grep.d.ts.map +1 -0
  555. package/dist/core/tools/renderers/grep.js +69 -0
  556. package/dist/core/tools/renderers/grep.js.map +1 -0
  557. package/dist/core/tools/renderers/index.d.ts +28 -0
  558. package/dist/core/tools/renderers/index.d.ts.map +1 -0
  559. package/dist/core/tools/renderers/index.js +47 -0
  560. package/dist/core/tools/renderers/index.js.map +1 -0
  561. package/dist/core/tools/renderers/ls.d.ts +10 -0
  562. package/dist/core/tools/renderers/ls.d.ts.map +1 -0
  563. package/dist/core/tools/renderers/ls.js +58 -0
  564. package/dist/core/tools/renderers/ls.js.map +1 -0
  565. package/dist/core/tools/renderers/read.d.ts +11 -0
  566. package/dist/core/tools/renderers/read.d.ts.map +1 -0
  567. package/dist/core/tools/renderers/read.js +130 -0
  568. package/dist/core/tools/renderers/read.js.map +1 -0
  569. package/dist/core/tools/renderers/write.d.ts +10 -0
  570. package/dist/core/tools/renderers/write.d.ts.map +1 -0
  571. package/dist/core/tools/renderers/write.js +153 -0
  572. package/dist/core/tools/renderers/write.js.map +1 -0
  573. package/dist/core/tools/tool-definition-wrapper.d.ts +5 -3
  574. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  575. package/dist/core/tools/tool-definition-wrapper.js +3 -1
  576. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  577. package/dist/core/tools/truncate.d.ts +14 -0
  578. package/dist/core/tools/truncate.d.ts.map +1 -1
  579. package/dist/core/tools/truncate.js +29 -0
  580. package/dist/core/tools/truncate.js.map +1 -1
  581. package/dist/core/tools/write.d.ts +4 -0
  582. package/dist/core/tools/write.d.ts.map +1 -1
  583. package/dist/core/tools/write.js +12 -147
  584. package/dist/core/tools/write.js.map +1 -1
  585. package/dist/core/trust-manager.d.ts +6 -4
  586. package/dist/core/trust-manager.d.ts.map +1 -1
  587. package/dist/core/trust-manager.js +59 -22
  588. package/dist/core/trust-manager.js.map +1 -1
  589. package/dist/core/usage-totals.d.ts +3 -1
  590. package/dist/core/usage-totals.d.ts.map +1 -1
  591. package/dist/core/usage-totals.js +28 -1
  592. package/dist/core/usage-totals.js.map +1 -1
  593. package/dist/core/virtual-models.d.ts +117 -0
  594. package/dist/core/virtual-models.d.ts.map +1 -0
  595. package/dist/core/virtual-models.js +124 -0
  596. package/dist/core/virtual-models.js.map +1 -0
  597. package/dist/experimental/micro/api.d.ts +81 -0
  598. package/dist/experimental/micro/api.d.ts.map +1 -0
  599. package/dist/experimental/micro/api.js +2 -0
  600. package/dist/experimental/micro/api.js.map +1 -0
  601. package/dist/experimental/micro/main.d.ts +3 -0
  602. package/dist/experimental/micro/main.d.ts.map +1 -0
  603. package/dist/experimental/micro/main.js +21 -0
  604. package/dist/experimental/micro/main.js.map +1 -0
  605. package/dist/experimental/micro/models.d.ts +11 -0
  606. package/dist/experimental/micro/models.d.ts.map +1 -0
  607. package/dist/experimental/micro/models.js +95 -0
  608. package/dist/experimental/micro/models.js.map +1 -0
  609. package/dist/experimental/micro/runtime.d.ts +12 -0
  610. package/dist/experimental/micro/runtime.d.ts.map +1 -0
  611. package/dist/experimental/micro/runtime.js +465 -0
  612. package/dist/experimental/micro/runtime.js.map +1 -0
  613. package/dist/experimental/micro/sessions.d.ts +10 -0
  614. package/dist/experimental/micro/sessions.d.ts.map +1 -0
  615. package/dist/experimental/micro/sessions.js +41 -0
  616. package/dist/experimental/micro/sessions.js.map +1 -0
  617. package/dist/experimental/micro/tools.d.ts +10 -0
  618. package/dist/experimental/micro/tools.d.ts.map +1 -0
  619. package/dist/experimental/micro/tools.js +96 -0
  620. package/dist/experimental/micro/tools.js.map +1 -0
  621. package/dist/experimental/micro/tui.d.ts +3 -0
  622. package/dist/experimental/micro/tui.d.ts.map +1 -0
  623. package/dist/experimental/micro/tui.js +510 -0
  624. package/dist/experimental/micro/tui.js.map +1 -0
  625. package/dist/experimental/mini/main.d.ts +7 -0
  626. package/dist/experimental/mini/main.d.ts.map +1 -0
  627. package/dist/experimental/mini/main.js +21 -0
  628. package/dist/experimental/mini/main.js.map +1 -0
  629. package/dist/experimental/mini/server/entry.d.ts +3 -0
  630. package/dist/experimental/mini/server/entry.d.ts.map +1 -0
  631. package/dist/experimental/mini/server/entry.js +11 -0
  632. package/dist/experimental/mini/server/entry.js.map +1 -0
  633. package/dist/experimental/mini/server/run.d.ts +13 -0
  634. package/dist/experimental/mini/server/run.d.ts.map +1 -0
  635. package/dist/experimental/mini/server/run.js +150 -0
  636. package/dist/experimental/mini/server/run.js.map +1 -0
  637. package/dist/experimental/mini/shared/protocol.d.ts +127 -0
  638. package/dist/experimental/mini/shared/protocol.d.ts.map +1 -0
  639. package/dist/experimental/mini/shared/protocol.js +13 -0
  640. package/dist/experimental/mini/shared/protocol.js.map +1 -0
  641. package/dist/experimental/mini/shared/rpc.d.ts +49 -0
  642. package/dist/experimental/mini/shared/rpc.d.ts.map +1 -0
  643. package/dist/experimental/mini/shared/rpc.js +171 -0
  644. package/dist/experimental/mini/shared/rpc.js.map +1 -0
  645. package/dist/experimental/mini/shared/transport.d.ts +35 -0
  646. package/dist/experimental/mini/shared/transport.d.ts.map +1 -0
  647. package/dist/experimental/mini/shared/transport.js +94 -0
  648. package/dist/experimental/mini/shared/transport.js.map +1 -0
  649. package/dist/experimental/mini/tui/run.d.ts +9 -0
  650. package/dist/experimental/mini/tui/run.d.ts.map +1 -0
  651. package/dist/experimental/mini/tui/run.js +62 -0
  652. package/dist/experimental/mini/tui/run.js.map +1 -0
  653. package/dist/experimental/mini/tui/session.d.ts +26 -0
  654. package/dist/experimental/mini/tui/session.d.ts.map +1 -0
  655. package/dist/experimental/mini/tui/session.js +94 -0
  656. package/dist/experimental/mini/tui/session.js.map +1 -0
  657. package/dist/experimental/mini/tui/view.d.ts +10 -0
  658. package/dist/experimental/mini/tui/view.d.ts.map +1 -0
  659. package/dist/experimental/mini/tui/view.js +461 -0
  660. package/dist/experimental/mini/tui/view.js.map +1 -0
  661. package/dist/experimental/mini/worker/entry.d.ts +3 -0
  662. package/dist/experimental/mini/worker/entry.d.ts.map +1 -0
  663. package/dist/experimental/mini/worker/entry.js +10 -0
  664. package/dist/experimental/mini/worker/entry.js.map +1 -0
  665. package/dist/experimental/mini/worker/lane-service.d.ts +44 -0
  666. package/dist/experimental/mini/worker/lane-service.d.ts.map +1 -0
  667. package/dist/experimental/mini/worker/lane-service.js +97 -0
  668. package/dist/experimental/mini/worker/lane-service.js.map +1 -0
  669. package/dist/experimental/mini/worker/models-service.d.ts +19 -0
  670. package/dist/experimental/mini/worker/models-service.d.ts.map +1 -0
  671. package/dist/experimental/mini/worker/models-service.js +136 -0
  672. package/dist/experimental/mini/worker/models-service.js.map +1 -0
  673. package/dist/experimental/mini/worker/run.d.ts +14 -0
  674. package/dist/experimental/mini/worker/run.d.ts.map +1 -0
  675. package/dist/experimental/mini/worker/run.js +88 -0
  676. package/dist/experimental/mini/worker/run.js.map +1 -0
  677. package/dist/extensions/codemode/execute.d.ts +16 -0
  678. package/dist/extensions/codemode/execute.d.ts.map +1 -0
  679. package/dist/extensions/codemode/execute.js +429 -0
  680. package/dist/extensions/codemode/execute.js.map +1 -0
  681. package/dist/extensions/codemode/execute.lazy.d.ts +3 -0
  682. package/dist/extensions/codemode/execute.lazy.d.ts.map +1 -0
  683. package/dist/extensions/codemode/execute.lazy.js +3 -0
  684. package/dist/extensions/codemode/execute.lazy.js.map +1 -0
  685. package/dist/extensions/codemode/index.d.ts +21 -0
  686. package/dist/extensions/codemode/index.d.ts.map +1 -0
  687. package/dist/extensions/codemode/index.js +31 -0
  688. package/dist/extensions/codemode/index.js.map +1 -0
  689. package/dist/extensions/codemode/renderer.d.ts +12 -0
  690. package/dist/extensions/codemode/renderer.d.ts.map +1 -0
  691. package/dist/extensions/codemode/renderer.js +137 -0
  692. package/dist/extensions/codemode/renderer.js.map +1 -0
  693. package/dist/extensions/codemode/tool.d.ts +123 -0
  694. package/dist/extensions/codemode/tool.d.ts.map +1 -0
  695. package/dist/extensions/codemode/tool.js +315 -0
  696. package/dist/extensions/codemode/tool.js.map +1 -0
  697. package/dist/extensions/codemode/worker.d.ts +7 -0
  698. package/dist/extensions/codemode/worker.d.ts.map +1 -0
  699. package/dist/extensions/codemode/worker.js +7 -0
  700. package/dist/extensions/codemode/worker.js.map +1 -0
  701. package/dist/extensions/index.d.ts.map +1 -1
  702. package/dist/extensions/index.js +13 -1
  703. package/dist/extensions/index.js.map +1 -1
  704. package/dist/extensions/llama/client.d.ts +8 -0
  705. package/dist/extensions/llama/client.d.ts.map +1 -1
  706. package/dist/extensions/llama/client.js +13 -0
  707. package/dist/extensions/llama/client.js.map +1 -1
  708. package/dist/extensions/llama/huggingface.js +2 -0
  709. package/dist/extensions/llama/huggingface.js.map +1 -1
  710. package/dist/extensions/llama/index.d.ts.map +1 -1
  711. package/dist/extensions/llama/index.js +13 -2
  712. package/dist/extensions/llama/index.js.map +1 -1
  713. package/dist/extensions/llama/provider.d.ts +4 -2
  714. package/dist/extensions/llama/provider.d.ts.map +1 -1
  715. package/dist/extensions/llama/provider.js +121 -15
  716. package/dist/extensions/llama/provider.js.map +1 -1
  717. package/dist/extensions/llama/ui.js +28 -12
  718. package/dist/extensions/llama/ui.js.map +1 -1
  719. package/dist/extensions/mcp/cli.d.ts +21 -0
  720. package/dist/extensions/mcp/cli.d.ts.map +1 -0
  721. package/dist/extensions/mcp/cli.js +500 -0
  722. package/dist/extensions/mcp/cli.js.map +1 -0
  723. package/dist/extensions/mcp/cli.lazy.d.ts +3 -0
  724. package/dist/extensions/mcp/cli.lazy.d.ts.map +1 -0
  725. package/dist/extensions/mcp/cli.lazy.js +3 -0
  726. package/dist/extensions/mcp/cli.lazy.js.map +1 -0
  727. package/dist/extensions/mcp/config.d.ts +72 -0
  728. package/dist/extensions/mcp/config.d.ts.map +1 -0
  729. package/dist/extensions/mcp/config.js +158 -0
  730. package/dist/extensions/mcp/config.js.map +1 -0
  731. package/dist/extensions/mcp/index.d.ts +76 -0
  732. package/dist/extensions/mcp/index.d.ts.map +1 -0
  733. package/dist/extensions/mcp/index.js +1055 -0
  734. package/dist/extensions/mcp/index.js.map +1 -0
  735. package/dist/extensions/mcp/log.d.ts +16 -0
  736. package/dist/extensions/mcp/log.d.ts.map +1 -0
  737. package/dist/extensions/mcp/log.js +66 -0
  738. package/dist/extensions/mcp/log.js.map +1 -0
  739. package/dist/extensions/mcp/oauth.d.ts +96 -0
  740. package/dist/extensions/mcp/oauth.d.ts.map +1 -0
  741. package/dist/extensions/mcp/oauth.js +333 -0
  742. package/dist/extensions/mcp/oauth.js.map +1 -0
  743. package/dist/extensions/mcp/resources.d.ts +43 -0
  744. package/dist/extensions/mcp/resources.d.ts.map +1 -0
  745. package/dist/extensions/mcp/resources.js +262 -0
  746. package/dist/extensions/mcp/resources.js.map +1 -0
  747. package/dist/extensions/mcp/runtime.d.ts +98 -0
  748. package/dist/extensions/mcp/runtime.d.ts.map +1 -0
  749. package/dist/extensions/mcp/runtime.js +394 -0
  750. package/dist/extensions/mcp/runtime.js.map +1 -0
  751. package/dist/extensions/mcp/runtime.lazy.d.ts +3 -0
  752. package/dist/extensions/mcp/runtime.lazy.d.ts.map +1 -0
  753. package/dist/extensions/mcp/runtime.lazy.js +3 -0
  754. package/dist/extensions/mcp/runtime.lazy.js.map +1 -0
  755. package/dist/extensions/mcp/tools.d.ts +84 -0
  756. package/dist/extensions/mcp/tools.d.ts.map +1 -0
  757. package/dist/extensions/mcp/tools.js +251 -0
  758. package/dist/extensions/mcp/tools.js.map +1 -0
  759. package/dist/extensions/mcp/ui.d.ts +60 -0
  760. package/dist/extensions/mcp/ui.d.ts.map +1 -0
  761. package/dist/extensions/mcp/ui.js +174 -0
  762. package/dist/extensions/mcp/ui.js.map +1 -0
  763. package/dist/extensions/stub-provider/index.d.ts +9 -0
  764. package/dist/extensions/stub-provider/index.d.ts.map +1 -0
  765. package/dist/extensions/stub-provider/index.js +13 -0
  766. package/dist/extensions/stub-provider/index.js.map +1 -0
  767. package/dist/extensions/stub-provider/provider.d.ts +77 -0
  768. package/dist/extensions/stub-provider/provider.d.ts.map +1 -0
  769. package/dist/extensions/stub-provider/provider.js +194 -0
  770. package/dist/extensions/stub-provider/provider.js.map +1 -0
  771. package/dist/extensions/tool-search/index.d.ts +12 -0
  772. package/dist/extensions/tool-search/index.d.ts.map +1 -0
  773. package/dist/extensions/tool-search/index.js +15 -0
  774. package/dist/extensions/tool-search/index.js.map +1 -0
  775. package/dist/extensions/tool-search/tool.d.ts +73 -0
  776. package/dist/extensions/tool-search/tool.d.ts.map +1 -0
  777. package/dist/extensions/tool-search/tool.js +189 -0
  778. package/dist/extensions/tool-search/tool.js.map +1 -0
  779. package/dist/hooks/gsd/draht-quality-gate.js +3 -3
  780. package/dist/index.d.ts +20 -11
  781. package/dist/index.d.ts.map +1 -1
  782. package/dist/index.js +12 -6
  783. package/dist/index.js.map +1 -1
  784. package/dist/main.d.ts +4 -0
  785. package/dist/main.d.ts.map +1 -1
  786. package/dist/main.js +365 -96
  787. package/dist/main.js.map +1 -1
  788. package/dist/migrations.d.ts +1 -1
  789. package/dist/migrations.js +7 -6
  790. package/dist/migrations.js.map +1 -1
  791. package/dist/modes/index.d.ts +1 -0
  792. package/dist/modes/index.d.ts.map +1 -1
  793. package/dist/modes/index.js.map +1 -1
  794. package/dist/modes/interactive/bug-report.d.ts +19 -0
  795. package/dist/modes/interactive/bug-report.d.ts.map +1 -0
  796. package/dist/modes/interactive/bug-report.js +211 -0
  797. package/dist/modes/interactive/bug-report.js.map +1 -0
  798. package/dist/modes/interactive/chat-viewport.d.ts +20 -0
  799. package/dist/modes/interactive/chat-viewport.d.ts.map +1 -0
  800. package/dist/modes/interactive/chat-viewport.js +28 -0
  801. package/dist/modes/interactive/chat-viewport.js.map +1 -0
  802. package/dist/modes/interactive/components/armin.js +10 -6
  803. package/dist/modes/interactive/components/armin.js.map +1 -1
  804. package/dist/modes/interactive/components/assistant-message.d.ts +6 -2
  805. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  806. package/dist/modes/interactive/components/assistant-message.js +38 -15
  807. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  808. package/dist/modes/interactive/components/bash-execution.js +9 -4
  809. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  810. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  811. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  812. package/dist/modes/interactive/components/branch-summary-message.d.ts +1 -1
  813. package/dist/modes/interactive/components/branch-summary-message.d.ts.map +1 -1
  814. package/dist/modes/interactive/components/branch-summary-message.js +15 -6
  815. package/dist/modes/interactive/components/branch-summary-message.js.map +1 -1
  816. package/dist/modes/interactive/components/compaction-summary-message.d.ts +1 -1
  817. package/dist/modes/interactive/components/compaction-summary-message.d.ts.map +1 -1
  818. package/dist/modes/interactive/components/compaction-summary-message.js +15 -6
  819. package/dist/modes/interactive/components/compaction-summary-message.js.map +1 -1
  820. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  821. package/dist/modes/interactive/components/config-selector.js +38 -10
  822. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  823. package/dist/modes/interactive/components/countdown-timer.js +5 -0
  824. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  825. package/dist/modes/interactive/components/custom-editor.d.ts +10 -1
  826. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  827. package/dist/modes/interactive/components/custom-editor.js +54 -2
  828. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  829. package/dist/modes/interactive/components/custom-entry.js +4 -1
  830. package/dist/modes/interactive/components/custom-entry.js.map +1 -1
  831. package/dist/modes/interactive/components/custom-message.js +7 -1
  832. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  833. package/dist/modes/interactive/components/daxnuts.js +8 -6
  834. package/dist/modes/interactive/components/daxnuts.js.map +1 -1
  835. package/dist/modes/interactive/components/dynamic-border.js +1 -0
  836. package/dist/modes/interactive/components/dynamic-border.js.map +1 -1
  837. package/dist/modes/interactive/components/extension-editor.d.ts +4 -1
  838. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  839. package/dist/modes/interactive/components/extension-editor.js +14 -3
  840. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  841. package/dist/modes/interactive/components/extension-input.d.ts +2 -0
  842. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  843. package/dist/modes/interactive/components/extension-input.js +14 -2
  844. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  845. package/dist/modes/interactive/components/extension-selector.d.ts +50 -0
  846. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  847. package/dist/modes/interactive/components/extension-selector.js +218 -6
  848. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  849. package/dist/modes/interactive/components/first-time-setup.d.ts +4 -4
  850. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -1
  851. package/dist/modes/interactive/components/first-time-setup.js +12 -4
  852. package/dist/modes/interactive/components/first-time-setup.js.map +1 -1
  853. package/dist/modes/interactive/components/footer.d.ts +7 -0
  854. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  855. package/dist/modes/interactive/components/footer.js +51 -6
  856. package/dist/modes/interactive/components/footer.js.map +1 -1
  857. package/dist/modes/interactive/components/index.d.ts +1 -1
  858. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  859. package/dist/modes/interactive/components/index.js.map +1 -1
  860. package/dist/modes/interactive/components/login-dialog.js +9 -3
  861. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  862. package/dist/modes/interactive/components/markdown-transform.d.ts +3 -0
  863. package/dist/modes/interactive/components/markdown-transform.d.ts.map +1 -0
  864. package/dist/modes/interactive/components/markdown-transform.js +19 -0
  865. package/dist/modes/interactive/components/markdown-transform.js.map +1 -0
  866. package/dist/modes/interactive/components/mermaid.d.ts +11 -0
  867. package/dist/modes/interactive/components/mermaid.d.ts.map +1 -0
  868. package/dist/modes/interactive/components/mermaid.js +75 -0
  869. package/dist/modes/interactive/components/mermaid.js.map +1 -0
  870. package/dist/modes/interactive/components/model-selector.d.ts +10 -4
  871. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  872. package/dist/modes/interactive/components/model-selector.js +101 -40
  873. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  874. package/dist/modes/interactive/components/oauth-selector.js +11 -3
  875. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  876. package/dist/modes/interactive/components/scoped-models-selector.d.ts +4 -0
  877. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  878. package/dist/modes/interactive/components/scoped-models-selector.js +60 -32
  879. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  880. package/dist/modes/interactive/components/session-selector.d.ts +5 -5
  881. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  882. package/dist/modes/interactive/components/session-selector.js +138 -80
  883. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  884. package/dist/modes/interactive/components/settings-selector.d.ts +25 -4
  885. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  886. package/dist/modes/interactive/components/settings-selector.js +240 -67
  887. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  888. package/dist/modes/interactive/components/settings-submenu.d.ts +72 -0
  889. package/dist/modes/interactive/components/settings-submenu.d.ts.map +1 -0
  890. package/dist/modes/interactive/components/settings-submenu.js +165 -0
  891. package/dist/modes/interactive/components/settings-submenu.js.map +1 -0
  892. package/dist/modes/interactive/components/show-images-selector.js +1 -0
  893. package/dist/modes/interactive/components/show-images-selector.js.map +1 -1
  894. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  895. package/dist/modes/interactive/components/skill-invocation-message.js +14 -5
  896. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  897. package/dist/modes/interactive/components/status-indicator.d.ts +3 -1
  898. package/dist/modes/interactive/components/status-indicator.d.ts.map +1 -1
  899. package/dist/modes/interactive/components/status-indicator.js +12 -3
  900. package/dist/modes/interactive/components/status-indicator.js.map +1 -1
  901. package/dist/modes/interactive/components/theme-selector.js +2 -0
  902. package/dist/modes/interactive/components/theme-selector.js.map +1 -1
  903. package/dist/modes/interactive/components/themed-text.d.ts +17 -0
  904. package/dist/modes/interactive/components/themed-text.d.ts.map +1 -0
  905. package/dist/modes/interactive/components/themed-text.js +29 -0
  906. package/dist/modes/interactive/components/themed-text.js.map +1 -0
  907. package/dist/modes/interactive/components/thinking-selector.d.ts +15 -3
  908. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  909. package/dist/modes/interactive/components/thinking-selector.js +76 -18
  910. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  911. package/dist/modes/interactive/components/tool-execution.d.ts +21 -4
  912. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  913. package/dist/modes/interactive/components/tool-execution.js +88 -53
  914. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  915. package/dist/modes/interactive/components/tree-selector.d.ts +20 -2
  916. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  917. package/dist/modes/interactive/components/tree-selector.js +65 -23
  918. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  919. package/dist/modes/interactive/components/trust-selector.js +8 -2
  920. package/dist/modes/interactive/components/trust-selector.js.map +1 -1
  921. package/dist/modes/interactive/components/user-message-selector.js +6 -3
  922. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  923. package/dist/modes/interactive/components/user-message.d.ts +3 -1
  924. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  925. package/dist/modes/interactive/components/user-message.js +12 -2
  926. package/dist/modes/interactive/components/user-message.js.map +1 -1
  927. package/dist/modes/interactive/components/visual-truncate.d.ts +27 -3
  928. package/dist/modes/interactive/components/visual-truncate.d.ts.map +1 -1
  929. package/dist/modes/interactive/components/visual-truncate.js +39 -6
  930. package/dist/modes/interactive/components/visual-truncate.js.map +1 -1
  931. package/dist/modes/interactive/external-editor.d.ts.map +1 -1
  932. package/dist/modes/interactive/external-editor.js +2 -1
  933. package/dist/modes/interactive/external-editor.js.map +1 -1
  934. package/dist/modes/interactive/interactive-mode.d.ts +166 -8
  935. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  936. package/dist/modes/interactive/interactive-mode.js +1690 -599
  937. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  938. package/dist/modes/interactive/model-catalog-refresh.d.ts +7 -0
  939. package/dist/modes/interactive/model-catalog-refresh.d.ts.map +1 -0
  940. package/dist/modes/interactive/model-catalog-refresh.js +34 -0
  941. package/dist/modes/interactive/model-catalog-refresh.js.map +1 -0
  942. package/dist/modes/interactive/session-share.d.ts +23 -0
  943. package/dist/modes/interactive/session-share.d.ts.map +1 -0
  944. package/dist/modes/interactive/session-share.js +130 -0
  945. package/dist/modes/interactive/session-share.js.map +1 -0
  946. package/dist/modes/interactive/theme/dark.json +54 -63
  947. package/dist/modes/interactive/theme/light.json +52 -60
  948. package/dist/modes/interactive/theme/system-theme.d.ts +54 -0
  949. package/dist/modes/interactive/theme/system-theme.d.ts.map +1 -0
  950. package/dist/modes/interactive/theme/system-theme.js +535 -0
  951. package/dist/modes/interactive/theme/system-theme.js.map +1 -0
  952. package/dist/modes/interactive/theme/theme-controller.d.ts +59 -7
  953. package/dist/modes/interactive/theme/theme-controller.d.ts.map +1 -1
  954. package/dist/modes/interactive/theme/theme-controller.js +164 -51
  955. package/dist/modes/interactive/theme/theme-controller.js.map +1 -1
  956. package/dist/modes/interactive/theme/theme-json.d.ts +85 -0
  957. package/dist/modes/interactive/theme/theme-json.d.ts.map +1 -0
  958. package/dist/modes/interactive/theme/theme-json.js +132 -0
  959. package/dist/modes/interactive/theme/theme-json.js.map +1 -0
  960. package/dist/modes/interactive/theme/theme-schema.json +24 -3
  961. package/dist/modes/interactive/theme/theme.d.ts +80 -42
  962. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  963. package/dist/modes/interactive/theme/theme.js +274 -417
  964. package/dist/modes/interactive/theme/theme.js.map +1 -1
  965. package/dist/modes/interactive/tui-renderer.d.ts +22 -0
  966. package/dist/modes/interactive/tui-renderer.d.ts.map +1 -0
  967. package/dist/modes/interactive/tui-renderer.js +67 -0
  968. package/dist/modes/interactive/tui-renderer.js.map +1 -0
  969. package/dist/modes/json-event.d.ts +34 -0
  970. package/dist/modes/json-event.d.ts.map +1 -0
  971. package/dist/modes/json-event.js +29 -0
  972. package/dist/modes/json-event.js.map +1 -0
  973. package/dist/modes/print-mode.d.ts +1 -1
  974. package/dist/modes/print-mode.d.ts.map +1 -1
  975. package/dist/modes/print-mode.js +12 -2
  976. package/dist/modes/print-mode.js.map +1 -1
  977. package/dist/modes/rpc/rpc-client.d.ts +17 -9
  978. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  979. package/dist/modes/rpc/rpc-client.js +27 -15
  980. package/dist/modes/rpc/rpc-client.js.map +1 -1
  981. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  982. package/dist/modes/rpc/rpc-mode.js +179 -19
  983. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  984. package/dist/modes/rpc/rpc-types.d.ts +90 -2
  985. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  986. package/dist/modes/rpc/rpc-types.js.map +1 -1
  987. package/dist/package-manager-cli.d.ts +1 -0
  988. package/dist/package-manager-cli.d.ts.map +1 -1
  989. package/dist/package-manager-cli.js +217 -63
  990. package/dist/package-manager-cli.js.map +1 -1
  991. package/dist/prompts/commands/atomic-commit.md +1 -12
  992. package/dist/prompts/commands/brainstorm.md +12 -15
  993. package/dist/prompts/commands/create-verification-skill.md +108 -0
  994. package/dist/prompts/commands/discuss-phase.md +3 -14
  995. package/dist/prompts/commands/execute-phase.md +3 -11
  996. package/dist/prompts/commands/fix.md +41 -18
  997. package/dist/prompts/commands/grill.md +66 -0
  998. package/dist/prompts/commands/init-project.md +5 -15
  999. package/dist/prompts/commands/map-codebase.md +1 -13
  1000. package/dist/prompts/commands/new-project.md +5 -15
  1001. package/dist/prompts/commands/next-milestone.md +1 -13
  1002. package/dist/prompts/commands/orchestrate.md +1 -1
  1003. package/dist/prompts/commands/pause-work.md +1 -13
  1004. package/dist/prompts/commands/plan-phase.md +3 -11
  1005. package/dist/prompts/commands/progress.md +0 -13
  1006. package/dist/prompts/commands/quick.md +3 -11
  1007. package/dist/prompts/commands/resolve-conflicts.md +71 -0
  1008. package/dist/prompts/commands/resume-work.md +0 -13
  1009. package/dist/prompts/commands/review.md +6 -13
  1010. package/dist/prompts/commands/triage.md +159 -0
  1011. package/dist/prompts/commands/verify-work.md +5 -14
  1012. package/dist/prompts/commands/why.md +139 -0
  1013. package/dist/rpc-entry.js +1 -0
  1014. package/dist/rpc-entry.js.map +1 -1
  1015. package/dist/skills/atomic-reasoning/SKILL.md +115 -0
  1016. package/dist/skills/blast-radius/SKILL.md +56 -0
  1017. package/dist/skills/epistemics/SKILL.md +99 -0
  1018. package/dist/skills/explainers/SKILL.md +65 -0
  1019. package/dist/skills/hexagon-animation/SKILL.md +49 -0
  1020. package/dist/skills/hexagon-animation/generate.mjs +81 -0
  1021. package/dist/skills/hexagon-animation/template.html +361 -0
  1022. package/dist/skills/typescript-discipline/SKILL.md +50 -0
  1023. package/dist/skills/typescript-discipline/references/patterns.md +294 -0
  1024. package/dist/skills/unslop/SKILL.md +119 -0
  1025. package/dist/utils/abort.d.ts +5 -0
  1026. package/dist/utils/abort.d.ts.map +1 -0
  1027. package/dist/utils/abort.js +48 -0
  1028. package/dist/utils/abort.js.map +1 -0
  1029. package/dist/utils/canonical-path.d.ts +28 -0
  1030. package/dist/utils/canonical-path.d.ts.map +1 -0
  1031. package/dist/utils/canonical-path.js +90 -0
  1032. package/dist/utils/canonical-path.js.map +1 -0
  1033. package/dist/utils/changelog.js +1 -1
  1034. package/dist/utils/changelog.js.map +1 -1
  1035. package/dist/utils/child-process.d.ts +13 -2
  1036. package/dist/utils/child-process.d.ts.map +1 -1
  1037. package/dist/utils/child-process.js +26 -9
  1038. package/dist/utils/child-process.js.map +1 -1
  1039. package/dist/utils/clipboard-command.d.ts +7 -0
  1040. package/dist/utils/clipboard-command.d.ts.map +1 -0
  1041. package/dist/utils/clipboard-command.js +45 -0
  1042. package/dist/utils/clipboard-command.js.map +1 -0
  1043. package/dist/utils/clipboard-image.d.ts.map +1 -1
  1044. package/dist/utils/clipboard-image.js +60 -91
  1045. package/dist/utils/clipboard-image.js.map +1 -1
  1046. package/dist/utils/clipboard.d.ts +3 -1
  1047. package/dist/utils/clipboard.d.ts.map +1 -1
  1048. package/dist/utils/clipboard.js +123 -108
  1049. package/dist/utils/clipboard.js.map +1 -1
  1050. package/dist/utils/draht-user-agent.d.ts +2 -0
  1051. package/dist/utils/draht-user-agent.d.ts.map +1 -0
  1052. package/dist/utils/draht-user-agent.js +5 -0
  1053. package/dist/utils/draht-user-agent.js.map +1 -0
  1054. package/dist/utils/exif-orientation.d.ts +2 -1
  1055. package/dist/utils/exif-orientation.d.ts.map +1 -1
  1056. package/dist/utils/exif-orientation.js +2 -3
  1057. package/dist/utils/exif-orientation.js.map +1 -1
  1058. package/dist/utils/frontmatter.d.ts.map +1 -1
  1059. package/dist/utils/frontmatter.js +2 -1
  1060. package/dist/utils/frontmatter.js.map +1 -1
  1061. package/dist/utils/management-http.d.ts +25 -0
  1062. package/dist/utils/management-http.d.ts.map +1 -0
  1063. package/dist/utils/management-http.js +54 -0
  1064. package/dist/utils/management-http.js.map +1 -0
  1065. package/dist/utils/mime.js +1 -1
  1066. package/dist/utils/mime.js.map +1 -1
  1067. package/dist/utils/paths.d.ts +6 -10
  1068. package/dist/utils/paths.d.ts.map +1 -1
  1069. package/dist/utils/paths.js +23 -14
  1070. package/dist/utils/paths.js.map +1 -1
  1071. package/dist/utils/photon.d.ts +2 -1
  1072. package/dist/utils/photon.d.ts.map +1 -1
  1073. package/dist/utils/photon.js.map +1 -1
  1074. package/dist/utils/shell.d.ts +4 -3
  1075. package/dist/utils/shell.d.ts.map +1 -1
  1076. package/dist/utils/shell.js +26 -39
  1077. package/dist/utils/shell.js.map +1 -1
  1078. package/dist/utils/syntax-highlight.d.ts +1 -0
  1079. package/dist/utils/syntax-highlight.d.ts.map +1 -1
  1080. package/dist/utils/syntax-highlight.js +62 -1
  1081. package/dist/utils/syntax-highlight.js.map +1 -1
  1082. package/dist/utils/text.d.ts +8 -0
  1083. package/dist/utils/text.d.ts.map +1 -0
  1084. package/dist/utils/text.js +9 -0
  1085. package/dist/utils/text.js.map +1 -0
  1086. package/dist/utils/tool-result-images.d.ts +21 -0
  1087. package/dist/utils/tool-result-images.d.ts.map +1 -0
  1088. package/dist/utils/tool-result-images.js +48 -0
  1089. package/dist/utils/tool-result-images.js.map +1 -0
  1090. package/dist/utils/tools-manager.d.ts +11 -1
  1091. package/dist/utils/tools-manager.d.ts.map +1 -1
  1092. package/dist/utils/tools-manager.js +56 -41
  1093. package/dist/utils/tools-manager.js.map +1 -1
  1094. package/dist/utils/version-check.d.ts +4 -1
  1095. package/dist/utils/version-check.d.ts.map +1 -1
  1096. package/dist/utils/version-check.js +30 -9
  1097. package/dist/utils/version-check.js.map +1 -1
  1098. package/dist/utils/wsl.d.ts +3 -0
  1099. package/dist/utils/wsl.d.ts.map +1 -0
  1100. package/dist/utils/wsl.js +15 -0
  1101. package/dist/utils/wsl.js.map +1 -0
  1102. package/dist/utils/zip.d.ts +7 -0
  1103. package/dist/utils/zip.d.ts.map +1 -0
  1104. package/dist/utils/zip.js +60 -0
  1105. package/dist/utils/zip.js.map +1 -0
  1106. package/docs/attachable-sessions.md +79 -0
  1107. package/docs/cli-integration.md +106 -0
  1108. package/docs/cli.md +374 -0
  1109. package/docs/compaction.md +107 -45
  1110. package/docs/configuration.md +47 -0
  1111. package/docs/containerization.md +100 -66
  1112. package/docs/custom-provider.md +109 -707
  1113. package/docs/docs.json +155 -95
  1114. package/docs/duet.md +42 -0
  1115. package/docs/environment-variables.md +30 -17
  1116. package/docs/extensions.md +169 -2811
  1117. package/docs/how-pi-works.md +53 -0
  1118. package/docs/images/interactive-mode.png +0 -0
  1119. package/docs/index.md +25 -69
  1120. package/docs/json.md +198 -57
  1121. package/docs/keybindings.md +89 -92
  1122. package/docs/llama-cpp.md +23 -8
  1123. package/docs/mcp.md +231 -0
  1124. package/docs/message-types.md +261 -0
  1125. package/docs/models.md +94 -478
  1126. package/docs/packages.md +68 -164
  1127. package/docs/prompt-templates.md +31 -68
  1128. package/docs/providers.md +118 -215
  1129. package/docs/quickstart.md +56 -109
  1130. package/docs/rpc-commands.md +860 -0
  1131. package/docs/rpc-extension-ui.md +200 -0
  1132. package/docs/rpc.md +186 -1494
  1133. package/docs/sdk.md +79 -1127
  1134. package/docs/security.md +77 -33
  1135. package/docs/session-format.md +98 -222
  1136. package/docs/sessions.md +36 -113
  1137. package/docs/settings.md +125 -251
  1138. package/docs/shell-aliases.md +85 -5
  1139. package/docs/skills.md +52 -188
  1140. package/docs/slash-commands.md +61 -0
  1141. package/docs/terminal-setup.md +132 -61
  1142. package/docs/termux.md +74 -84
  1143. package/docs/themes.md +91 -252
  1144. package/docs/tmux.md +31 -39
  1145. package/docs/tui.md +74 -891
  1146. package/docs/usage.md +54 -255
  1147. package/docs/virtual-models.md +114 -0
  1148. package/docs/windows.md +57 -7
  1149. package/examples/extensions/antigravity-image-gen.ts +9 -9
  1150. package/examples/extensions/bash-spawn-hook.ts +1 -1
  1151. package/examples/extensions/border-status-editor.ts +1 -1
  1152. package/examples/extensions/built-in-tool-renderer.ts +16 -40
  1153. package/examples/extensions/custom-compaction.ts +1 -16
  1154. package/examples/extensions/custom-provider-anthropic/index.ts +20 -13
  1155. package/examples/extensions/custom-provider-gitlab-duo/index.ts +4 -3
  1156. package/examples/extensions/custom-provider-gitlab-duo/test.ts +5 -5
  1157. package/examples/extensions/debug-provider.ts +90 -0
  1158. package/examples/extensions/doom-overlay/wad-finder.ts +7 -3
  1159. package/examples/extensions/dynamic-resources/dynamic.json +3 -1
  1160. package/examples/extensions/git-checkpoint.ts +2 -2
  1161. package/examples/extensions/handoff.ts +2 -11
  1162. package/examples/extensions/jev-router.ts +113 -0
  1163. package/examples/extensions/minimal-mode.ts +24 -96
  1164. package/examples/extensions/notify.ts +3 -1
  1165. package/examples/extensions/overlay-qa-tests.ts +3 -3
  1166. package/examples/extensions/prompt-customizer.ts +19 -67
  1167. package/examples/extensions/qna.ts +3 -7
  1168. package/examples/extensions/subagent/agents.ts +40 -9
  1169. package/examples/extensions/subagent/index.ts +27 -4
  1170. package/examples/extensions/summarize.ts +7 -18
  1171. package/examples/extensions/titlebar-spinner.ts +1 -1
  1172. package/examples/rpc-client.ts +35 -0
  1173. package/examples/rpc-extension-ui.ts +38 -9
  1174. package/examples/sdk/02-custom-model.ts +1 -2
  1175. package/examples/sdk/06-extensions.ts +1 -1
  1176. package/examples/sdk/09-api-keys-and-oauth.ts +1 -1
  1177. package/examples/sdk/12-full-control.ts +1 -1
  1178. package/examples/sdk/14-codemode-mcp.ts +61 -0
  1179. package/hooks/gsd/draht-quality-gate.js +3 -3
  1180. package/package.json +28 -32
  1181. package/prompts/commands/atomic-commit.md +1 -12
  1182. package/prompts/commands/brainstorm.md +12 -15
  1183. package/prompts/commands/create-verification-skill.md +108 -0
  1184. package/prompts/commands/discuss-phase.md +3 -14
  1185. package/prompts/commands/execute-phase.md +3 -11
  1186. package/prompts/commands/fix.md +41 -18
  1187. package/prompts/commands/grill.md +66 -0
  1188. package/prompts/commands/init-project.md +5 -15
  1189. package/prompts/commands/map-codebase.md +1 -13
  1190. package/prompts/commands/new-project.md +5 -15
  1191. package/prompts/commands/next-milestone.md +1 -13
  1192. package/prompts/commands/orchestrate.md +1 -1
  1193. package/prompts/commands/pause-work.md +1 -13
  1194. package/prompts/commands/plan-phase.md +3 -11
  1195. package/prompts/commands/progress.md +0 -13
  1196. package/prompts/commands/quick.md +3 -11
  1197. package/prompts/commands/resolve-conflicts.md +71 -0
  1198. package/prompts/commands/resume-work.md +0 -13
  1199. package/prompts/commands/review.md +6 -13
  1200. package/prompts/commands/triage.md +159 -0
  1201. package/prompts/commands/verify-work.md +5 -14
  1202. package/prompts/commands/why.md +139 -0
  1203. package/skills/atomic-reasoning/SKILL.md +115 -0
  1204. package/skills/blast-radius/SKILL.md +56 -0
  1205. package/skills/epistemics/SKILL.md +99 -0
  1206. package/skills/explainers/SKILL.md +65 -0
  1207. package/skills/hexagon-animation/SKILL.md +49 -0
  1208. package/skills/hexagon-animation/generate.mjs +81 -0
  1209. package/skills/hexagon-animation/template.html +361 -0
  1210. package/skills/typescript-discipline/SKILL.md +50 -0
  1211. package/skills/typescript-discipline/references/patterns.md +294 -0
  1212. package/skills/unslop/SKILL.md +119 -0
  1213. package/dist/prompts/agents/build.md +0 -86
  1214. package/dist/prompts/agents/plan.md +0 -79
  1215. package/dist/prompts/agents/verify.md +0 -69
  1216. package/dist/utils/clipboard-native.d.ts +0 -11
  1217. package/dist/utils/clipboard-native.d.ts.map +0 -1
  1218. package/dist/utils/clipboard-native.js +0 -20
  1219. package/dist/utils/clipboard-native.js.map +0 -1
  1220. package/dist/utils/pi-user-agent.d.ts +0 -2
  1221. package/dist/utils/pi-user-agent.d.ts.map +0 -1
  1222. package/dist/utils/pi-user-agent.js +0 -5
  1223. package/dist/utils/pi-user-agent.js.map +0 -1
  1224. package/docs/development.md +0 -71
  1225. package/docs/tree.md +0 -231
  1226. package/examples/extensions/kimi-deferred-tools.ts +0 -61
  1227. package/prompts/agents/build.md +0 -86
  1228. package/prompts/agents/plan.md +0 -79
  1229. package/prompts/agents/verify.md +0 -69
@@ -0,0 +1,901 @@
1
+ /**
2
+ * CheckpointManager — working-tree snapshot capture and durable storage (Phase 41).
3
+ *
4
+ * Captures git snapshots of the working tree via a temporary index
5
+ * (`GIT_INDEX_FILE` + `add -A` + `write-tree` + `commit-tree`) and anchors
6
+ * them at `refs/draht/checkpoints/<session-id>/<entry-id>` so they are
7
+ * GC-proof and invisible to the user's git workflow: the user's index,
8
+ * `HEAD`, stash, and reflog are never touched, and `git stash` is never used.
9
+ *
10
+ * Metadata lives in a sidecar JSONL next to the session file
11
+ * (`<session-file>.checkpoints.jsonl`).
12
+ */
13
+ import { execFile } from "node:child_process";
14
+ import { randomUUID } from "node:crypto";
15
+ import { appendFileSync, copyFileSync, existsSync, lstatSync, mkdirSync, mkdtempSync, readdirSync, readFileSync, rmdirSync, rmSync, statSync, utimesSync, writeFileSync, } from "node:fs";
16
+ import { tmpdir } from "node:os";
17
+ import { basename, dirname, join, resolve, sep } from "node:path";
18
+ import { promisify } from "node:util";
19
+ const execFileAsync = promisify(execFile);
20
+ /** Ref namespace for checkpoint snapshots: `refs/draht/checkpoints/<session-id>/<entry-id>`. */
21
+ export const CHECKPOINT_REF_PREFIX = "refs/draht/checkpoints";
22
+ /**
23
+ * Ref-name segment marking a pre-rewind safety snapshot. Keeps safety refs out
24
+ * of the plain `<session-id>/<entry-id>` name space so capturing one can never
25
+ * overwrite the checkpoint already anchored for that entry.
26
+ */
27
+ export const SAFETY_REF_SEGMENT = "pre-rewind";
28
+ const MILLISECONDS_PER_DAY = 86_400_000;
29
+ /**
30
+ * Identity for snapshot commits. Passed explicitly so capture works in
31
+ * repositories (and environments) with no configured git identity — the user's
32
+ * own config is never read for this and never written.
33
+ */
34
+ const CHECKPOINT_IDENTITY = {
35
+ GIT_AUTHOR_NAME: "draht",
36
+ GIT_AUTHOR_EMAIL: "checkpoints@draht.local",
37
+ GIT_COMMITTER_NAME: "draht",
38
+ GIT_COMMITTER_EMAIL: "checkpoints@draht.local",
39
+ };
40
+ /** Raw stdout, untrimmed — required for `-z` output whose records end in NUL. */
41
+ async function gitRaw(cwd, args, extraEnv) {
42
+ const { stdout } = await execFileAsync("git", args, {
43
+ cwd,
44
+ env: extraEnv ? { ...process.env, ...extraEnv } : process.env,
45
+ maxBuffer: 64 * 1024 * 1024,
46
+ });
47
+ return stdout;
48
+ }
49
+ async function git(cwd, args, extraEnv) {
50
+ return (await gitRaw(cwd, args, extraEnv)).trim();
51
+ }
52
+ /** Run git with caller-provided stdin, used for NUL-delimited path batches. */
53
+ async function gitWithInput(cwd, args, input, extraEnv) {
54
+ return await new Promise((resolve, reject) => {
55
+ const child = execFile("git", args, {
56
+ cwd,
57
+ env: extraEnv ? { ...process.env, ...extraEnv } : process.env,
58
+ encoding: "utf8",
59
+ maxBuffer: 64 * 1024 * 1024,
60
+ }, (error, stdout) => {
61
+ if (error)
62
+ reject(error);
63
+ else
64
+ resolve(stdout.trim());
65
+ });
66
+ // The process callback owns command failures. In particular, a git
67
+ // refusal can close stdin early and surface EPIPE here as a second error.
68
+ child.stdin?.on("error", () => { });
69
+ child.stdin?.end(input);
70
+ });
71
+ }
72
+ function describeError(error) {
73
+ return error instanceof Error ? error.message : String(error);
74
+ }
75
+ async function isGitRepository(cwd) {
76
+ try {
77
+ return (await git(cwd, ["rev-parse", "--is-inside-work-tree"])) === "true";
78
+ }
79
+ catch {
80
+ return false;
81
+ }
82
+ }
83
+ /**
84
+ * Make one path component safe to use inside a git ref name. Session ids and
85
+ * entry ids are opaque to us, so anything `git check-ref-format` would reject
86
+ * (`..`, control/special characters, leading or trailing punctuation, a
87
+ * `.lock` suffix) is folded to `-`.
88
+ */
89
+ /**
90
+ * A fresh id for one snapshot: sortable-ish prefix, random suffix, and safe to
91
+ * paste straight into a ref name (`sanitizeRefComponent` leaves it untouched).
92
+ */
93
+ function newRecoveryId() {
94
+ return `${Date.now().toString(36)}-${randomUUID().slice(0, 8)}`;
95
+ }
96
+ function sanitizeRefComponent(value) {
97
+ let out = value.replace(/[^A-Za-z0-9._-]/g, "-").replace(/\.{2,}/g, "-");
98
+ out = out.replace(/^[.-]+/, "").replace(/[.-]+$/, "");
99
+ if (out.endsWith(".lock"))
100
+ out = `${out.slice(0, -".lock".length)}-lock`;
101
+ return out.length > 0 ? out : "checkpoint";
102
+ }
103
+ /**
104
+ * Diff two snapshot trees into the paths a restore has to write and the paths
105
+ * it has to delete. `--no-renames` keeps every record a plain status/path pair;
106
+ * `-z` keeps paths literal so filenames with spaces or newlines survive.
107
+ */
108
+ async function diffTrees(top, fromTree, toTree) {
109
+ const raw = await gitRaw(top, ["diff-tree", "-r", "-z", "--no-renames", "--name-status", fromTree, toTree]);
110
+ const tokens = raw.split("\0");
111
+ const diff = { writes: [], deletes: [], added: [] };
112
+ for (let i = 0; i + 1 < tokens.length; i += 2) {
113
+ const status = tokens[i];
114
+ const path = tokens[i + 1];
115
+ if (status.length === 0 || path.length === 0)
116
+ continue;
117
+ // D = present in `fromTree`, absent in `toTree`. Everything else
118
+ // (A/M/T) exists in `toTree` and has to be written out of it.
119
+ if (status.startsWith("D")) {
120
+ diff.deletes.push(path);
121
+ continue;
122
+ }
123
+ diff.writes.push(path);
124
+ if (status.startsWith("A"))
125
+ diff.added.push(path);
126
+ }
127
+ return diff;
128
+ }
129
+ /** Path arguments per read-only git invocation, so a huge query cannot overflow ARG_MAX. */
130
+ const GIT_PATH_BATCH = 200;
131
+ /** Paths written by one checkout-index process during restore. */
132
+ export const DEFAULT_RESTORE_WRITE_CHUNK_SIZE = 200;
133
+ /** Ignore-rule file that can live inside a snapshot tree. */
134
+ const IGNORE_RULE_FILE = ".gitignore";
135
+ /** Directory entries, or none when the directory cannot be read. */
136
+ function readDirEntries(dir) {
137
+ try {
138
+ return readdirSync(dir, { withFileTypes: true });
139
+ }
140
+ catch {
141
+ return [];
142
+ }
143
+ }
144
+ /** `lstat`-based existence: a dangling symlink exists for our purposes. */
145
+ function pathExists(full) {
146
+ try {
147
+ lstatSync(full);
148
+ return true;
149
+ }
150
+ catch {
151
+ return false;
152
+ }
153
+ }
154
+ /** Quote at most five paths for a refusal message. */
155
+ function formatPathList(paths) {
156
+ const shown = paths.slice(0, 5).map((path) => `"${path}"`);
157
+ const rest = paths.length - shown.length;
158
+ return rest > 0 ? `${shown.join(", ")} and ${rest} more` : shown.join(", ");
159
+ }
160
+ /**
161
+ * Object type (`blob`, `tree`, `commit`) of each given path in a tree; paths
162
+ * absent from the tree are absent from the map. `ls-tree` resolves exact paths
163
+ * without `-r`, so the cost tracks the paths asked about, not the tree size.
164
+ */
165
+ async function treeEntryTypes(top, tree, paths) {
166
+ const types = new Map();
167
+ for (let i = 0; i < paths.length; i += GIT_PATH_BATCH) {
168
+ // Literal pathspecs: a path containing `*` or `[` is a filename here,
169
+ // never a glob.
170
+ const raw = await gitRaw(top, ["ls-tree", "-z", tree, "--", ...paths.slice(i, i + GIT_PATH_BATCH)], {
171
+ GIT_LITERAL_PATHSPECS: "1",
172
+ });
173
+ for (const record of raw.split("\0")) {
174
+ // "<mode> SP <type> SP <object> TAB <path>"
175
+ const tab = record.indexOf("\t");
176
+ if (tab < 0)
177
+ continue;
178
+ const type = record.slice(0, tab).split(" ")[1];
179
+ if (type)
180
+ types.set(record.slice(tab + 1), type);
181
+ }
182
+ }
183
+ return types;
184
+ }
185
+ /**
186
+ * The shallowest directory at or under `full` that is a git repository, or
187
+ * undefined when there is none. `.git` is a directory in a clone and a file in
188
+ * a linked worktree, so both shapes count.
189
+ */
190
+ function findGitRepositoryUnder(full) {
191
+ let stat;
192
+ try {
193
+ stat = lstatSync(full);
194
+ }
195
+ catch {
196
+ return undefined;
197
+ }
198
+ if (!stat.isDirectory())
199
+ return undefined;
200
+ // Breadth-first, so the reported path is the shallowest repository found.
201
+ const queue = [full];
202
+ while (queue.length > 0) {
203
+ const dir = queue.shift();
204
+ const entries = readDirEntries(dir);
205
+ if (entries.some((entry) => entry.name === ".git"))
206
+ return dir;
207
+ // Symlinked directories are not descended: git never snapshotted
208
+ // through them, so a restore cannot have scheduled anything inside.
209
+ for (const entry of entries)
210
+ if (entry.isDirectory())
211
+ queue.push(join(dir, entry.name));
212
+ }
213
+ return undefined;
214
+ }
215
+ /**
216
+ * Paths scheduled for deletion that are — or contain — a nested git repository.
217
+ *
218
+ * `git add -A` collapses an embedded clone or a `git worktree add` checkout
219
+ * into a single gitlink entry, so deleting OR overwriting that one path takes the nested
220
+ * repository's `.git` with it: its committed history and any uncommitted work
221
+ * are destroyed, and no snapshot holds either (a gitlink records only a commit
222
+ * id). There is no safe way to put that back, so a restore that would do it is
223
+ * refused rather than attempted.
224
+ */
225
+ async function findNestedRepositories(top, fromTree, paths) {
226
+ if (paths.length === 0)
227
+ return [];
228
+ const root = resolve(top);
229
+ const types = await treeEntryTypes(top, fromTree, paths);
230
+ const found = [];
231
+ for (const path of paths) {
232
+ // A gitlink ("commit") entry is a nested repository by definition.
233
+ if (types.get(path) === "commit" || findGitRepositoryUnder(join(root, path)) !== undefined)
234
+ found.push(path);
235
+ }
236
+ return found;
237
+ }
238
+ /**
239
+ * Paths the restore would create that already exist on disk while being absent
240
+ * from the pre-rewind snapshot.
241
+ *
242
+ * The safety snapshot images everything git can see, so an existing path it
243
+ * does not contain is content no snapshot holds — an ignored file, most often,
244
+ * which is precisely what happens when `.gitignore` changed between capture
245
+ * and restore. Overwriting it is unrecoverable, so the restore is refused.
246
+ */
247
+ function findUncapturedWrites(top, added) {
248
+ const root = resolve(top);
249
+ return added.filter((path) => pathExists(join(root, path)));
250
+ }
251
+ /**
252
+ * Ignore-rule files that differ between the two snapshots. The "ignored files
253
+ * are never in a snapshot, never in the diff, never touched" invariant only
254
+ * holds while the rules are the same at capture and at restore; when they
255
+ * drift, a path can be tracked in one snapshot and ignored in the other and so
256
+ * be deleted although the user believes it is ignored. Detected, not guessed
257
+ * at: a drifting rule set with deletions pending is refused.
258
+ */
259
+ function findIgnoreRuleDrift(diff) {
260
+ return [...diff.writes, ...diff.deletes].filter((path) => basename(path) === IGNORE_RULE_FILE);
261
+ }
262
+ /**
263
+ * Pre-flight refusal check, run after the safety snapshot and before the first
264
+ * mutation. Returns the refusal message, or undefined when the restore is safe
265
+ * to apply. Fails closed by design: every case here is one where proceeding
266
+ * could destroy content no snapshot can bring back.
267
+ */
268
+ async function findRestoreHazard(top, fromTree, diff) {
269
+ // Every mutated path, not just deletes: a nested repository sitting where the
270
+ // target tree holds a blob diffs as a typechange and lands in `writes`, where
271
+ // `git checkout-index -f` destroys it exactly as a delete would.
272
+ const nested = await findNestedRepositories(top, fromTree, [...diff.deletes, ...diff.writes]);
273
+ if (nested.length > 0) {
274
+ return `refusing to restore: ${formatPathList(nested)} would be removed or overwritten, and that is a nested git repository (or a directory holding one) — doing so would take its history and any uncommitted work with it, and no snapshot holds either. Move or remove it yourself, then rewind again.`;
275
+ }
276
+ const uncaptured = findUncapturedWrites(top, diff.added);
277
+ if (uncaptured.length > 0) {
278
+ return `refusing to restore: ${formatPathList(uncaptured)} exists in the working tree but is in no snapshot (ignored, or otherwise invisible to git), so restoring would overwrite content nothing can bring back. Move it aside, or stop ignoring it so it gets snapshotted, then rewind again.`;
279
+ }
280
+ const drift = findIgnoreRuleDrift(diff);
281
+ if (drift.length > 0 && diff.deletes.length > 0) {
282
+ return `refusing to restore: the ignore rules in ${formatPathList(drift)} differ between this checkpoint and the working tree, so a file that is ignored in one snapshot and tracked in the other could be deleted. Undo the ignore-rule change first, or rewind with "Conversation only".`;
283
+ }
284
+ return undefined;
285
+ }
286
+ /** Remove a worktree path and any directories the removal left empty. */
287
+ function deleteWorktreePath(top, path) {
288
+ // `git rev-parse --show-toplevel` reports forward slashes even on Windows;
289
+ // resolve so the prune loop compares like-for-like separators.
290
+ const root = resolve(top);
291
+ const full = join(root, path);
292
+ // Last line of defence for the one call that recursively deletes: a nested
293
+ // git repository must never be removed, because nothing snapshots it. The
294
+ // restore refuses long before this (`findNestedRepositories`); reaching
295
+ // here means the tree changed under us, so abort and let the caller roll
296
+ // back rather than delete a repository.
297
+ const nested = findGitRepositoryUnder(full);
298
+ if (nested !== undefined) {
299
+ throw new Error(`refusing to delete "${path}": ${nested} is a git repository and no snapshot holds it`);
300
+ }
301
+ rmSync(full, { force: true, recursive: true });
302
+ // Prune the directories the removal emptied, the way git's own checkout does.
303
+ for (let dir = dirname(full); dir !== root && dir.startsWith(root + sep); dir = dirname(dir)) {
304
+ try {
305
+ if (readdirSync(dir).length > 0)
306
+ break;
307
+ rmdirSync(dir);
308
+ }
309
+ catch {
310
+ break;
311
+ }
312
+ }
313
+ }
314
+ /**
315
+ * Apply a tree diff to the working tree, writing the `writes` paths out of
316
+ * `sourceTree` through a throwaway index. Deletions run first: a path can be a
317
+ * file in one tree and a directory in the other, and clearing the old shape
318
+ * first keeps the checkout from colliding with it.
319
+ */
320
+ async function applyTreeDiff(top, sourceTree, diff, onPathsRestored, writeChunkSize = DEFAULT_RESTORE_WRITE_CHUNK_SIZE) {
321
+ for (const path of diff.deletes) {
322
+ deleteWorktreePath(top, path);
323
+ await onPathsRestored?.([path]);
324
+ }
325
+ if (diff.writes.length === 0)
326
+ return;
327
+ const indexDir = mkdtempSync(join(tmpdir(), "draht-checkpoint-restore-"));
328
+ try {
329
+ const indexEnv = { ...CHECKPOINT_IDENTITY, GIT_INDEX_FILE: join(indexDir, "index") };
330
+ await git(top, ["read-tree", sourceTree], indexEnv);
331
+ for (let i = 0; i < diff.writes.length; i += writeChunkSize) {
332
+ const paths = diff.writes.slice(i, i + writeChunkSize);
333
+ // `-f` overwrites existing files and creates missing parent
334
+ // directories. `--stdin -z` keeps hostile path names literal without
335
+ // putting them in argv; the user's own index remains untouched.
336
+ await gitWithInput(top, ["checkout-index", "-f", "-u", "--stdin", "-z"], `${paths.join("\0")}\0`, indexEnv);
337
+ await onPathsRestored?.(paths);
338
+ }
339
+ }
340
+ finally {
341
+ rmSync(indexDir, { recursive: true, force: true });
342
+ }
343
+ }
344
+ /** Path of the checkpoint metadata sidecar for a session file. */
345
+ export function checkpointSidecarPath(sessionFile) {
346
+ return `${sessionFile}.checkpoints.jsonl`;
347
+ }
348
+ /**
349
+ * Name of the in-progress marker, written inside the repository's git
350
+ * directory (per worktree, like the rest of git's own state) so it is found
351
+ * again from any session that opens the same tree.
352
+ */
353
+ export const RESTORE_MARKER_FILE = "draht-restore-in-progress.json";
354
+ function stringOrUndefined(value) {
355
+ return typeof value === "string" && value.length > 0 ? value : undefined;
356
+ }
357
+ /**
358
+ * Read the marker, if there is one. A marker that exists but cannot be parsed
359
+ * still reports an interrupted restore — its presence is the signal; its
360
+ * contents are only the detail — so corruption can never downgrade to "fine".
361
+ */
362
+ function readRestoreMarker(markerPath) {
363
+ if (!existsSync(markerPath))
364
+ return undefined;
365
+ try {
366
+ const parsed = JSON.parse(readFileSync(markerPath, "utf8"));
367
+ return {
368
+ markerPath,
369
+ safetyRef: stringOrUndefined(parsed.safetyRef) ?? "",
370
+ safetyRecoveryId: stringOrUndefined(parsed.safetyRecoveryId),
371
+ targetRef: stringOrUndefined(parsed.targetRef),
372
+ targetEntryId: stringOrUndefined(parsed.targetEntryId),
373
+ currentEntryId: stringOrUndefined(parsed.currentEntryId),
374
+ startedAt: stringOrUndefined(parsed.startedAt),
375
+ };
376
+ }
377
+ catch {
378
+ return { markerPath, safetyRef: "" };
379
+ }
380
+ }
381
+ function writeRestoreMarker(markerPath, marker) {
382
+ mkdirSync(dirname(markerPath), { recursive: true });
383
+ writeFileSync(markerPath, `${JSON.stringify(marker, null, "\t")}\n`);
384
+ }
385
+ function clearRestoreMarker(markerPath) {
386
+ rmSync(markerPath, { force: true });
387
+ }
388
+ /** The message shown when a previous restore is found to have been interrupted. */
389
+ export function describeInterruptedRestore(marker) {
390
+ const recovery = marker.safetyRef.length > 0
391
+ ? `Your pre-rewind files are snapshotted at ${marker.safetyRef} — recover them with \`git checkout ${marker.safetyRef} -- .\``
392
+ : "The marker could not be read, so the safety ref is unknown — look for one under refs/draht/checkpoints/";
393
+ const started = marker.startedAt ? ` (started ${marker.startedAt})` : "";
394
+ return `refusing to restore: a previous restore was interrupted${started} and the working tree may be between two snapshots. ${recovery}. Delete ${marker.markerPath} once the tree is the way you want it.`;
395
+ }
396
+ function toCheckpointRecord(value) {
397
+ if (typeof value !== "object" || value === null)
398
+ return undefined;
399
+ const candidate = value;
400
+ if (typeof candidate.entryId !== "string" ||
401
+ typeof candidate.ref !== "string" ||
402
+ typeof candidate.treeHash !== "string" ||
403
+ typeof candidate.timestamp !== "string" ||
404
+ typeof candidate.dirtyFileCount !== "number") {
405
+ return undefined;
406
+ }
407
+ const record = {
408
+ entryId: candidate.entryId,
409
+ ref: candidate.ref,
410
+ treeHash: candidate.treeHash,
411
+ timestamp: candidate.timestamp,
412
+ dirtyFileCount: candidate.dirtyFileCount,
413
+ };
414
+ // Optional: sidecars written before recovery ids existed stay readable.
415
+ if (typeof candidate.recoveryId === "string")
416
+ record.recoveryId = candidate.recoveryId;
417
+ if (candidate.kind === "safety" || candidate.kind === "checkpoint")
418
+ record.kind = candidate.kind;
419
+ return record;
420
+ }
421
+ /** Read all valid records from a sidecar file. Malformed lines are skipped. */
422
+ export function readCheckpointSidecar(sidecarPath) {
423
+ if (!existsSync(sidecarPath))
424
+ return [];
425
+ let content;
426
+ try {
427
+ content = readFileSync(sidecarPath, "utf8");
428
+ }
429
+ catch {
430
+ return [];
431
+ }
432
+ const records = [];
433
+ for (const line of content.split("\n")) {
434
+ const trimmed = line.trim();
435
+ if (trimmed.length === 0)
436
+ continue;
437
+ let parsed;
438
+ try {
439
+ parsed = JSON.parse(trimmed);
440
+ }
441
+ catch {
442
+ continue;
443
+ }
444
+ const record = toCheckpointRecord(parsed);
445
+ if (record)
446
+ records.push(record);
447
+ }
448
+ return records;
449
+ }
450
+ function appendCheckpointRecord(sidecarPath, record) {
451
+ mkdirSync(dirname(sidecarPath), { recursive: true });
452
+ appendFileSync(sidecarPath, `${JSON.stringify(record)}\n`);
453
+ }
454
+ /**
455
+ * Copy sidecar records for preserved entry ids from one session file's
456
+ * sidecar to another's (used by /fork and /clone). Returns the number of
457
+ * records copied. Refs are copied verbatim — they keep pointing at the
458
+ * source session's namespace, which stays anchored in the repository.
459
+ */
460
+ export function propagateCheckpointSidecar(sourceSessionFile, targetSessionFile, preservedEntryIds) {
461
+ const source = readCheckpointSidecar(checkpointSidecarPath(sourceSessionFile));
462
+ const kept = source.filter((record) => preservedEntryIds.has(record.entryId));
463
+ if (kept.length === 0)
464
+ return 0;
465
+ const target = checkpointSidecarPath(targetSessionFile);
466
+ mkdirSync(dirname(target), { recursive: true });
467
+ writeFileSync(target, `${kept.map((record) => JSON.stringify(record)).join("\n")}\n`);
468
+ return kept.length;
469
+ }
470
+ export class CheckpointManager {
471
+ cwd;
472
+ sessionId;
473
+ sidecarPath;
474
+ onCaptured;
475
+ constructor(options) {
476
+ this.cwd = options.cwd;
477
+ this.sessionId = options.sessionId;
478
+ this.sidecarPath = checkpointSidecarPath(options.sessionFile);
479
+ this.onCaptured = options.onCaptured;
480
+ }
481
+ /**
482
+ * Capture a snapshot of the working tree keyed to the given session entry
483
+ * id, unless the tree hash equals the previous checkpoint's (dedup).
484
+ * Never throws for expected conditions: non-git cwds report "disabled",
485
+ * git failures report "failed".
486
+ */
487
+ async captureIfChanged(entryId) {
488
+ if (!(await isGitRepository(this.cwd))) {
489
+ return { status: "disabled", reason: `${this.cwd} is not inside a git repository` };
490
+ }
491
+ try {
492
+ const treeHash = await this.writeTreeSnapshot();
493
+ const previous = this.list().at(-1);
494
+ if (previous?.treeHash === treeHash)
495
+ return { status: "deduplicated" };
496
+ const recoveryId = newRecoveryId();
497
+ const base = `${CHECKPOINT_REF_PREFIX}/${sanitizeRefComponent(this.sessionId)}/${sanitizeRefComponent(entryId)}`;
498
+ // A second capture for the same entry id (a retried or re-entered
499
+ // turn) must not overwrite the first: `update-ref` would drop the
500
+ // only anchor of a tree the user can still rewind to. Suffix
501
+ // instead, and let the sidecar order decide which one `get` returns.
502
+ const ref = (await this.refExists(base)) ? `${base}-${recoveryId}` : base;
503
+ await this.anchorTree(treeHash, ref, `draht checkpoint ${entryId}`);
504
+ const record = await this.recordSnapshot(entryId, ref, treeHash, recoveryId, "checkpoint");
505
+ try {
506
+ await this.onCaptured?.(record);
507
+ }
508
+ catch {
509
+ // A listener failure never turns a captured checkpoint into a failed one.
510
+ }
511
+ return { status: "created", record };
512
+ }
513
+ catch (error) {
514
+ return { status: "failed", reason: describeError(error) };
515
+ }
516
+ }
517
+ /**
518
+ * Snapshot the working tree into a throwaway index and return its tree
519
+ * hash. A private index keeps `add -A` off the user's real index entirely,
520
+ * and `add -A` honours `.gitignore` for *untracked* files, so ignored files
521
+ * never enter a snapshot — and therefore can never be restored or deleted
522
+ * by a rewind.
523
+ *
524
+ * The throwaway index is seeded from the user's real one first. Ignore
525
+ * rules never apply to a path git already tracks, so seeding is what keeps
526
+ * a tracked-but-ignored file (`git add -f secret.env` with `secret.env` in
527
+ * `.gitignore`) inside the snapshot: from an empty index every path looks
528
+ * untracked, and such files silently fell out of every snapshot while
529
+ * restores still reported success.
530
+ */
531
+ async writeTreeSnapshot() {
532
+ const indexDir = mkdtempSync(join(tmpdir(), "draht-checkpoint-index-"));
533
+ try {
534
+ const indexFile = join(indexDir, "index");
535
+ const indexEnv = { ...CHECKPOINT_IDENTITY, GIT_INDEX_FILE: indexFile };
536
+ await this.seedSnapshotIndex(indexFile, indexEnv);
537
+ await git(this.cwd, ["add", "-A"], indexEnv);
538
+ return await git(this.cwd, ["write-tree"], indexEnv);
539
+ }
540
+ finally {
541
+ rmSync(indexDir, { recursive: true, force: true });
542
+ }
543
+ }
544
+ /**
545
+ * Copy the user's index into the throwaway one so its tracked set carries
546
+ * over. Read-only with respect to the real index — it is copied, never
547
+ * written back, and `git rev-parse --git-path index` resolves the effective
548
+ * index (split-index links resolve against the git dir, so a copy still
549
+ * reads). Falls back to `read-tree HEAD`, whose tracked set is the next
550
+ * best answer, and to an empty index when HEAD is unborn — where nothing is
551
+ * tracked and empty is the correct answer.
552
+ */
553
+ async seedSnapshotIndex(indexFile, indexEnv) {
554
+ try {
555
+ const realIndex = resolve(this.cwd, await git(this.cwd, ["rev-parse", "--git-path", "index"]));
556
+ if (existsSync(realIndex)) {
557
+ // Stat before copying: a copy of an index rewritten mid-stat then
558
+ // carries a too-old timestamp, which only widens the re-check below.
559
+ const stat = statSync(realIndex);
560
+ copyFileSync(realIndex, indexFile);
561
+ // The copy must not look newer than the index it was taken from.
562
+ // Git re-checks the content of any entry whose cached mtime is not
563
+ // older than the index file's own mtime (its racy-timestamp
564
+ // protection); a fresh-mtimed copy silences that for every entry,
565
+ // so a file rewritten with the same size within the stat
566
+ // granularity of its cached entry kept its stale blob and the
567
+ // stale content leaked into snapshots (and out of restores).
568
+ utimesSync(indexFile, stat.atime, stat.mtime);
569
+ return;
570
+ }
571
+ }
572
+ catch {
573
+ // Fall through to the HEAD-based seed.
574
+ }
575
+ try {
576
+ await git(this.cwd, ["read-tree", "HEAD"], indexEnv);
577
+ }
578
+ catch {
579
+ // Unborn HEAD: nothing is tracked, so the empty index is correct.
580
+ }
581
+ }
582
+ /** Whether a ref already exists, without throwing for the common "it does not" case. */
583
+ async refExists(ref) {
584
+ try {
585
+ await git(this.cwd, ["rev-parse", "--verify", "--quiet", `${ref}^{commit}`]);
586
+ return true;
587
+ }
588
+ catch {
589
+ return false;
590
+ }
591
+ }
592
+ /** Absolute path of this repository's in-progress restore marker. */
593
+ async restoreMarkerPath() {
594
+ return join(resolve(this.cwd, await git(this.cwd, ["rev-parse", "--git-dir"])), RESTORE_MARKER_FILE);
595
+ }
596
+ /** Anchor a tree behind a commit at `ref` so it survives GC. */
597
+ async anchorTree(treeHash, ref, message) {
598
+ const commit = await git(this.cwd, ["commit-tree", treeHash, "-m", message], CHECKPOINT_IDENTITY);
599
+ await git(this.cwd, ["update-ref", ref, commit], CHECKPOINT_IDENTITY);
600
+ }
601
+ /** Append the sidecar record for an anchored snapshot. */
602
+ async recordSnapshot(entryId, ref, treeHash, recoveryId, kind) {
603
+ const record = {
604
+ entryId,
605
+ ref,
606
+ treeHash,
607
+ timestamp: new Date().toISOString(),
608
+ dirtyFileCount: await this.countDirtyFiles(treeHash),
609
+ recoveryId,
610
+ kind,
611
+ };
612
+ appendCheckpointRecord(this.sidecarPath, record);
613
+ return record;
614
+ }
615
+ /**
616
+ * Capture the pre-rewind safety snapshot (R42-RWD.3). Unlike
617
+ * `captureIfChanged` this never dedups — the rewind must always have an
618
+ * anchored ref to roll back to — and it never reuses the plain checkpoint
619
+ * ref name, so an existing checkpoint for the same entry id is preserved.
620
+ * The record is keyed to the current leaf so that rewinding back to it is
621
+ * a redo of the abandoned state.
622
+ */
623
+ async captureSafetySnapshot(entryId) {
624
+ const treeHash = await this.writeTreeSnapshot();
625
+ const recoveryId = newRecoveryId();
626
+ const ref = `${CHECKPOINT_REF_PREFIX}/${sanitizeRefComponent(this.sessionId)}/${SAFETY_REF_SEGMENT}-${sanitizeRefComponent(entryId)}-${recoveryId}`;
627
+ await this.anchorTree(treeHash, ref, `draht pre-rewind snapshot ${entryId}`);
628
+ return await this.recordSnapshot(entryId, ref, treeHash, recoveryId, "safety");
629
+ }
630
+ /**
631
+ * Restore the working tree to the checkpoint recorded for `targetEntryId`
632
+ * (R42-RWD.3, R42-RWD.4).
633
+ *
634
+ * Ordering is fixed: a safety snapshot of the current tree is captured and
635
+ * anchored *before* anything is mutated, then the two snapshot trees are
636
+ * diffed and only the differing paths are touched — differing paths are
637
+ * checked out of the target snapshot, paths absent from it are deleted.
638
+ * Deliberately not `git stash apply` and not `git checkout -- .`: both
639
+ * clobber untracked and ignored state. Ignored files are never in a
640
+ * snapshot, so they are never in the diff and never touched.
641
+ *
642
+ * Before the first mutation the diff is checked for the cases where that
643
+ * reasoning does not hold, and the whole restore is refused (`failed`,
644
+ * nothing touched) rather than applied part-way:
645
+ * - a path to delete that is, or contains, a nested git repository;
646
+ * - a path to create that already exists on disk yet is in no snapshot;
647
+ * - ignore rules that differ between the snapshots while deletions pend.
648
+ * A refusal is recoverable, a deletion is not.
649
+ *
650
+ * Any failure after the first mutation rolls the tree back to the safety
651
+ * snapshot; if that rollback also fails, both refs are reported on the
652
+ * result rather than left implicit. An in-progress marker in the git dir
653
+ * names the safety ref for as long as the tree is being mutated, so an
654
+ * interrupted restore is never silent. Never throws.
655
+ */
656
+ async restore(options) {
657
+ const untouched = { restored: [], deleted: [] };
658
+ const writeChunkSize = options.writeChunkSize ?? DEFAULT_RESTORE_WRITE_CHUNK_SIZE;
659
+ if (!Number.isSafeInteger(writeChunkSize) || writeChunkSize < 1) {
660
+ return {
661
+ status: "failed",
662
+ ...untouched,
663
+ reason: `restore writeChunkSize must be a positive safe integer, got ${writeChunkSize}`,
664
+ };
665
+ }
666
+ if (!(await isGitRepository(this.cwd))) {
667
+ return { status: "disabled", ...untouched, reason: `${this.cwd} is not inside a git repository` };
668
+ }
669
+ // Resolved before the safety snapshot is recorded, so the lookup cannot
670
+ // pick up the safety record this call is about to append. A recovery id
671
+ // addresses one specific snapshot, which is the only way to reach a
672
+ // safety snapshot that a later rewind from the same leaf shadows.
673
+ const target = this.get(options.targetEntryId) ?? this.getRecoveryPoint(options.targetEntryId);
674
+ if (!target) {
675
+ return { status: "failed", ...untouched, reason: `no checkpoint recorded for entry ${options.targetEntryId}` };
676
+ }
677
+ let top;
678
+ let markerPath;
679
+ let targetTree;
680
+ let safety;
681
+ try {
682
+ // Plumbing below addresses index paths, which are relative to the
683
+ // repository root rather than to this manager's cwd.
684
+ top = await git(this.cwd, ["rev-parse", "--show-toplevel"]);
685
+ markerPath = await this.restoreMarkerPath();
686
+ // A marker still on disk means a previous restore never finished, so
687
+ // the tree is somewhere between two snapshots and diffing against a
688
+ // fresh snapshot of it would bake that half-state in. Refuse, and
689
+ // name the ref that recovers the tree.
690
+ const interrupted = readRestoreMarker(markerPath);
691
+ if (interrupted) {
692
+ return { status: "failed", ...untouched, target, reason: describeInterruptedRestore(interrupted) };
693
+ }
694
+ // Resolve through the ref so a pruned or corrupt snapshot fails here,
695
+ // before the safety snapshot and before any mutation.
696
+ targetTree = await git(top, ["rev-parse", "--verify", `${target.ref}^{tree}`]);
697
+ safety = await this.captureSafetySnapshot(options.currentEntryId);
698
+ }
699
+ catch (error) {
700
+ return { status: "failed", ...untouched, target, reason: describeError(error) };
701
+ }
702
+ if (targetTree === safety.treeHash) {
703
+ return { status: "unchanged", ...untouched, safety, target };
704
+ }
705
+ let diff;
706
+ let hazard;
707
+ try {
708
+ diff = await diffTrees(top, safety.treeHash, targetTree);
709
+ // Every hazard here is content the snapshots cannot bring back, so
710
+ // the restore is refused whole rather than applied part-way. Nothing
711
+ // has been mutated at this point.
712
+ hazard = await findRestoreHazard(top, safety.treeHash, diff);
713
+ }
714
+ catch (error) {
715
+ return { status: "failed", ...untouched, safety, target, reason: describeError(error) };
716
+ }
717
+ if (hazard) {
718
+ return { status: "failed", ...untouched, safety, target, reason: hazard };
719
+ }
720
+ try {
721
+ // Written before the first mutation so an interrupted restore — a
722
+ // SIGINT, a crash, a pulled plug — leaves behind the name of the ref
723
+ // that recovers the tree. Cancellation itself is out of scope; this
724
+ // only guarantees the interruption is never silent.
725
+ writeRestoreMarker(markerPath, {
726
+ safetyRef: safety.ref,
727
+ safetyRecoveryId: safety.recoveryId,
728
+ targetRef: target.ref,
729
+ targetEntryId: options.targetEntryId,
730
+ currentEntryId: options.currentEntryId,
731
+ startedAt: new Date().toISOString(),
732
+ });
733
+ }
734
+ catch (error) {
735
+ return {
736
+ status: "failed",
737
+ ...untouched,
738
+ safety,
739
+ target,
740
+ reason: `could not write the restore marker at ${markerPath}: ${describeError(error)}`,
741
+ };
742
+ }
743
+ try {
744
+ await applyTreeDiff(top, targetTree, diff, options.onPathsRestored, writeChunkSize);
745
+ clearRestoreMarker(markerPath);
746
+ return { status: "restored", restored: diff.writes, deleted: diff.deletes, safety, target };
747
+ }
748
+ catch (error) {
749
+ const reason = describeError(error);
750
+ try {
751
+ // The inverse diff covers exactly the paths the forward pass could
752
+ // have touched, and re-applying it is idempotent for the ones it
753
+ // never reached.
754
+ const inverse = await diffTrees(top, targetTree, safety.treeHash);
755
+ await applyTreeDiff(top, safety.treeHash, inverse, undefined, writeChunkSize);
756
+ clearRestoreMarker(markerPath);
757
+ return { status: "rolled-back", ...untouched, safety, target, reason };
758
+ }
759
+ catch (rollbackError) {
760
+ // Marker deliberately left in place: the tree really is between
761
+ // two snapshots, and the next restore has to say so.
762
+ return {
763
+ status: "unrecoverable",
764
+ ...untouched,
765
+ safety,
766
+ target,
767
+ reason,
768
+ rollbackReason: describeError(rollbackError),
769
+ };
770
+ }
771
+ }
772
+ }
773
+ /**
774
+ * Restore files and then move the conversation leaf, in that order
775
+ * (R42-RWD.5). `navigate` runs only once the file restore has succeeded,
776
+ * so a caller cannot move the leaf ahead of the working tree. Never throws.
777
+ */
778
+ async rewind(options) {
779
+ const { navigate, ...restoreOptions } = options;
780
+ const restore = await this.restore(restoreOptions);
781
+ if (restore.status !== "restored" && restore.status !== "unchanged") {
782
+ return { restore, navigated: false };
783
+ }
784
+ try {
785
+ await navigate();
786
+ return { restore, navigated: true };
787
+ }
788
+ catch (error) {
789
+ return { restore, navigated: false, navigateReason: describeError(error) };
790
+ }
791
+ }
792
+ /** Files in the snapshot that differ from HEAD; the whole tree when HEAD is unborn. */
793
+ async countDirtyFiles(treeHash) {
794
+ try {
795
+ const headTree = await git(this.cwd, ["rev-parse", "--verify", "HEAD^{tree}"]);
796
+ const diff = await git(this.cwd, ["diff", "--name-only", headTree, treeHash]);
797
+ return diff.length === 0 ? 0 : diff.split("\n").length;
798
+ }
799
+ catch {
800
+ const files = await git(this.cwd, ["ls-tree", "-r", "--name-only", treeHash]);
801
+ return files.length === 0 ? 0 : files.split("\n").length;
802
+ }
803
+ }
804
+ /** All sidecar records for this session, in capture order. */
805
+ list() {
806
+ return readCheckpointSidecar(this.sidecarPath);
807
+ }
808
+ /** Latest record for an entry id, if any. */
809
+ get(entryId) {
810
+ const records = this.list();
811
+ for (let i = records.length - 1; i >= 0; i--) {
812
+ if (records[i].entryId === entryId)
813
+ return records[i];
814
+ }
815
+ return undefined;
816
+ }
817
+ /**
818
+ * The one snapshot with this recovery id. `get` answers "the newest
819
+ * snapshot for this entry", which by design shadows older ones — two
820
+ * rewinds from the same leaf record two safety snapshots under the same
821
+ * entry id. This addresses a single snapshot, so no recovery point is ever
822
+ * unreachable, and `restore` accepts a recovery id wherever it accepts an
823
+ * entry id.
824
+ */
825
+ getRecoveryPoint(recoveryId) {
826
+ return this.list().find((record) => record.recoveryId === recoveryId);
827
+ }
828
+ /** Every pre-rewind safety snapshot, oldest first — the undo history of `/rewind`. */
829
+ listSafetySnapshots() {
830
+ return this.list().filter((record) => record.kind === "safety");
831
+ }
832
+ /**
833
+ * The marker left behind by a restore that never finished, if there is one
834
+ * (D5). Call it at startup to tell the user which ref recovers their tree;
835
+ * `restore` refuses while it is present. Clearing it is the user's decision
836
+ * (`clearInterruptedRestore`), because only they know whether the tree is
837
+ * the way they want it.
838
+ */
839
+ static async findInterruptedRestore(cwd) {
840
+ if (!(await isGitRepository(cwd)))
841
+ return undefined;
842
+ try {
843
+ return readRestoreMarker(join(resolve(cwd, await git(cwd, ["rev-parse", "--git-dir"])), RESTORE_MARKER_FILE));
844
+ }
845
+ catch {
846
+ return undefined;
847
+ }
848
+ }
849
+ /** Acknowledge an interrupted restore, re-enabling `restore`. Returns whether a marker was cleared. */
850
+ static async clearInterruptedRestore(cwd) {
851
+ const marker = await CheckpointManager.findInterruptedRestore(cwd);
852
+ if (!marker)
853
+ return false;
854
+ clearRestoreMarker(marker.markerPath);
855
+ return true;
856
+ }
857
+ /** Delete checkpoint refs per the retention policy. Repo-wide, all sessions. */
858
+ static async pruneRepository(cwd, options = {}) {
859
+ if (!(await isGitRepository(cwd)))
860
+ return { examined: 0, deleted: [] };
861
+ const listing = await git(cwd, [
862
+ "for-each-ref",
863
+ "--format=%(refname)%09%(committerdate:iso-strict)",
864
+ CHECKPOINT_REF_PREFIX,
865
+ ]);
866
+ const refs = (listing.length === 0 ? [] : listing.split("\n")).flatMap((line) => {
867
+ const [refname, committedAt] = line.split("\t");
868
+ if (!refname || !committedAt)
869
+ return [];
870
+ const at = new Date(committedAt).getTime();
871
+ return Number.isNaN(at) ? [] : [{ refname, at }];
872
+ });
873
+ const doomed = new Set();
874
+ const cutoff = (options.now ?? new Date()).getTime() - (options.retentionDays ?? 30) * MILLISECONDS_PER_DAY;
875
+ for (const ref of refs) {
876
+ if (ref.at < cutoff)
877
+ doomed.add(ref.refname);
878
+ }
879
+ if (options.maxPerSession !== undefined) {
880
+ const bySession = new Map();
881
+ for (const ref of refs) {
882
+ const session = ref.refname.slice(CHECKPOINT_REF_PREFIX.length + 1).split("/")[0] ?? "";
883
+ const group = bySession.get(session) ?? [];
884
+ group.push(ref);
885
+ bySession.set(session, group);
886
+ }
887
+ for (const group of bySession.values()) {
888
+ const newestFirst = [...group].sort((a, b) => b.at - a.at);
889
+ for (const surplus of newestFirst.slice(options.maxPerSession))
890
+ doomed.add(surplus.refname);
891
+ }
892
+ }
893
+ const deleted = [...doomed].sort();
894
+ if (!options.dryRun) {
895
+ for (const ref of deleted)
896
+ await git(cwd, ["update-ref", "-d", ref]);
897
+ }
898
+ return { examined: refs.length, deleted };
899
+ }
900
+ }
901
+ //# sourceMappingURL=checkpoint-manager.js.map