@draht/coding-agent 2026.4.26 → 2026.6.11

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 (621) hide show
  1. package/CHANGELOG.md +43 -0
  2. package/bin/draht-tools.cjs +3809 -1
  3. package/dist/bun/cli.d.ts.map +1 -1
  4. package/dist/bun/cli.js +4 -2
  5. package/dist/bun/cli.js.map +1 -1
  6. package/dist/bun/restore-sandbox-env.d.ts +13 -0
  7. package/dist/bun/restore-sandbox-env.d.ts.map +1 -0
  8. package/dist/bun/restore-sandbox-env.js +32 -0
  9. package/dist/bun/restore-sandbox-env.js.map +1 -0
  10. package/dist/cli/args.d.ts +9 -4
  11. package/dist/cli/args.d.ts.map +1 -1
  12. package/dist/cli/args.js +88 -35
  13. package/dist/cli/args.js.map +1 -1
  14. package/dist/cli/config-selector.d.ts +2 -2
  15. package/dist/cli/config-selector.d.ts.map +1 -1
  16. package/dist/cli/config-selector.js +1 -1
  17. package/dist/cli/config-selector.js.map +1 -1
  18. package/dist/cli/file-processor.d.ts.map +1 -1
  19. package/dist/cli/file-processor.js +2 -3
  20. package/dist/cli/file-processor.js.map +1 -1
  21. package/dist/cli/initial-message.d.ts +1 -1
  22. package/dist/cli/initial-message.d.ts.map +1 -1
  23. package/dist/cli/initial-message.js.map +1 -1
  24. package/dist/cli/list-models.d.ts +1 -1
  25. package/dist/cli/list-models.d.ts.map +1 -1
  26. package/dist/cli/list-models.js +7 -1
  27. package/dist/cli/list-models.js.map +1 -1
  28. package/dist/cli/project-trust.d.ts +10 -0
  29. package/dist/cli/project-trust.d.ts.map +1 -0
  30. package/dist/cli/project-trust.js +48 -0
  31. package/dist/cli/project-trust.js.map +1 -0
  32. package/dist/cli/session-picker.d.ts +1 -1
  33. package/dist/cli/session-picker.d.ts.map +1 -1
  34. package/dist/cli/session-picker.js.map +1 -1
  35. package/dist/cli/startup-ui.d.ts +16 -0
  36. package/dist/cli/startup-ui.d.ts.map +1 -0
  37. package/dist/cli/startup-ui.js +112 -0
  38. package/dist/cli/startup-ui.js.map +1 -0
  39. package/dist/cli.d.ts.map +1 -1
  40. package/dist/cli.js +7 -4
  41. package/dist/cli.js.map +1 -1
  42. package/dist/config.d.ts +23 -13
  43. package/dist/config.d.ts.map +1 -1
  44. package/dist/config.js +264 -62
  45. package/dist/config.js.map +1 -1
  46. package/dist/core/agent-session-runtime.d.ts +45 -9
  47. package/dist/core/agent-session-runtime.d.ts.map +1 -1
  48. package/dist/core/agent-session-runtime.js +100 -33
  49. package/dist/core/agent-session-runtime.js.map +1 -1
  50. package/dist/core/agent-session-services.d.ts +6 -4
  51. package/dist/core/agent-session-services.d.ts.map +1 -1
  52. package/dist/core/agent-session-services.js +7 -4
  53. package/dist/core/agent-session-services.js.map +1 -1
  54. package/dist/core/agent-session.d.ts +47 -31
  55. package/dist/core/agent-session.d.ts.map +1 -1
  56. package/dist/core/agent-session.js +470 -443
  57. package/dist/core/agent-session.js.map +1 -1
  58. package/dist/core/auth-guidance.d.ts +5 -0
  59. package/dist/core/auth-guidance.d.ts.map +1 -0
  60. package/dist/core/auth-guidance.js +21 -0
  61. package/dist/core/auth-guidance.js.map +1 -0
  62. package/dist/core/auth-storage.d.ts +10 -1
  63. package/dist/core/auth-storage.d.ts.map +1 -1
  64. package/dist/core/auth-storage.js +27 -6
  65. package/dist/core/auth-storage.js.map +1 -1
  66. package/dist/core/bash-executor.d.ts +1 -15
  67. package/dist/core/bash-executor.d.ts.map +1 -1
  68. package/dist/core/bash-executor.js +10 -24
  69. package/dist/core/bash-executor.js.map +1 -1
  70. package/dist/core/builtins/subagent.d.ts.map +1 -1
  71. package/dist/core/builtins/subagent.js +1 -2
  72. package/dist/core/builtins/subagent.js.map +1 -1
  73. package/dist/core/compaction/branch-summarization.d.ts +6 -4
  74. package/dist/core/compaction/branch-summarization.d.ts.map +1 -1
  75. package/dist/core/compaction/branch-summarization.js +9 -3
  76. package/dist/core/compaction/branch-summarization.js.map +1 -1
  77. package/dist/core/compaction/compaction.d.ts +5 -5
  78. package/dist/core/compaction/compaction.d.ts.map +1 -1
  79. package/dist/core/compaction/compaction.js +43 -37
  80. package/dist/core/compaction/compaction.js.map +1 -1
  81. package/dist/core/compaction/index.d.ts +3 -3
  82. package/dist/core/compaction/index.d.ts.map +1 -1
  83. package/dist/core/compaction/index.js.map +1 -1
  84. package/dist/core/compaction/utils.d.ts +1 -1
  85. package/dist/core/compaction/utils.d.ts.map +1 -1
  86. package/dist/core/compaction/utils.js +1 -1
  87. package/dist/core/compaction/utils.js.map +1 -1
  88. package/dist/core/exec.d.ts.map +1 -1
  89. package/dist/core/exec.js.map +1 -1
  90. package/dist/core/experimental.d.ts +2 -0
  91. package/dist/core/experimental.d.ts.map +1 -0
  92. package/dist/core/experimental.js +4 -0
  93. package/dist/core/experimental.js.map +1 -0
  94. package/dist/core/export-html/ansi-to-html.d.ts.map +1 -1
  95. package/dist/core/export-html/ansi-to-html.js +1 -1
  96. package/dist/core/export-html/ansi-to-html.js.map +1 -1
  97. package/dist/core/export-html/index.d.ts +1 -1
  98. package/dist/core/export-html/index.d.ts.map +1 -1
  99. package/dist/core/export-html/index.js +13 -11
  100. package/dist/core/export-html/index.js.map +1 -1
  101. package/dist/core/export-html/template.css +69 -4
  102. package/dist/core/export-html/template.js +231 -57
  103. package/dist/core/export-html/tool-renderer.d.ts +0 -6
  104. package/dist/core/export-html/tool-renderer.d.ts.map +1 -1
  105. package/dist/core/export-html/tool-renderer.js +15 -2
  106. package/dist/core/export-html/tool-renderer.js.map +1 -1
  107. package/dist/core/extensions/index.d.ts +8 -8
  108. package/dist/core/extensions/index.d.ts.map +1 -1
  109. package/dist/core/extensions/index.js.map +1 -1
  110. package/dist/core/extensions/loader.d.ts +3 -3
  111. package/dist/core/extensions/loader.d.ts.map +1 -1
  112. package/dist/core/extensions/loader.js +27 -35
  113. package/dist/core/extensions/loader.js.map +1 -1
  114. package/dist/core/extensions/runner.d.ts +30 -12
  115. package/dist/core/extensions/runner.d.ts.map +1 -1
  116. package/dist/core/extensions/runner.js +215 -32
  117. package/dist/core/extensions/runner.js.map +1 -1
  118. package/dist/core/extensions/types.d.ts +163 -35
  119. package/dist/core/extensions/types.d.ts.map +1 -1
  120. package/dist/core/extensions/types.js.map +1 -1
  121. package/dist/core/extensions/wrapper.d.ts.map +1 -1
  122. package/dist/core/extensions/wrapper.js +2 -2
  123. package/dist/core/extensions/wrapper.js.map +1 -1
  124. package/dist/core/footer-data-provider.d.ts +7 -1
  125. package/dist/core/footer-data-provider.d.ts.map +1 -1
  126. package/dist/core/footer-data-provider.js +78 -54
  127. package/dist/core/footer-data-provider.js.map +1 -1
  128. package/dist/core/http-dispatcher.d.ts +21 -0
  129. package/dist/core/http-dispatcher.d.ts.map +1 -0
  130. package/dist/core/http-dispatcher.js +48 -0
  131. package/dist/core/http-dispatcher.js.map +1 -0
  132. package/dist/core/index.d.ts +9 -8
  133. package/dist/core/index.d.ts.map +1 -1
  134. package/dist/core/index.js +2 -1
  135. package/dist/core/index.js.map +1 -1
  136. package/dist/core/keybindings.d.ts +66 -1
  137. package/dist/core/keybindings.d.ts.map +1 -1
  138. package/dist/core/keybindings.js +56 -1
  139. package/dist/core/keybindings.js.map +1 -1
  140. package/dist/core/model-registry.d.ts +22 -4
  141. package/dist/core/model-registry.d.ts.map +1 -1
  142. package/dist/core/model-registry.js +216 -44
  143. package/dist/core/model-registry.js.map +1 -1
  144. package/dist/core/model-resolver.d.ts +2 -1
  145. package/dist/core/model-resolver.d.ts.map +1 -1
  146. package/dist/core/model-resolver.js +48 -21
  147. package/dist/core/model-resolver.js.map +1 -1
  148. package/dist/core/output-guard.d.ts +1 -0
  149. package/dist/core/output-guard.d.ts.map +1 -1
  150. package/dist/core/output-guard.js +52 -22
  151. package/dist/core/output-guard.js.map +1 -1
  152. package/dist/core/package-manager.d.ts +17 -2
  153. package/dist/core/package-manager.d.ts.map +1 -1
  154. package/dist/core/package-manager.js +363 -121
  155. package/dist/core/package-manager.js.map +1 -1
  156. package/dist/core/project-trust.d.ts +15 -0
  157. package/dist/core/project-trust.d.ts.map +1 -0
  158. package/dist/core/project-trust.js +58 -0
  159. package/dist/core/project-trust.js.map +1 -0
  160. package/dist/core/prompt-templates.d.ts +13 -11
  161. package/dist/core/prompt-templates.d.ts.map +1 -1
  162. package/dist/core/prompt-templates.js +67 -76
  163. package/dist/core/prompt-templates.js.map +1 -1
  164. package/dist/core/provider-attribution.d.ts +4 -0
  165. package/dist/core/provider-attribution.d.ts.map +1 -0
  166. package/dist/core/provider-attribution.js +72 -0
  167. package/dist/core/provider-attribution.js.map +1 -0
  168. package/dist/core/provider-display-names.d.ts +2 -0
  169. package/dist/core/provider-display-names.d.ts.map +1 -0
  170. package/dist/core/provider-display-names.js +36 -0
  171. package/dist/core/provider-display-names.js.map +1 -0
  172. package/dist/core/resolve-config-value.d.ts +9 -1
  173. package/dist/core/resolve-config-value.d.ts.map +1 -1
  174. package/dist/core/resolve-config-value.js +134 -11
  175. package/dist/core/resolve-config-value.js.map +1 -1
  176. package/dist/core/resource-loader.d.ts +34 -14
  177. package/dist/core/resource-loader.d.ts.map +1 -1
  178. package/dist/core/resource-loader.js +165 -76
  179. package/dist/core/resource-loader.js.map +1 -1
  180. package/dist/core/sdk.d.ts +26 -10
  181. package/dist/core/sdk.d.ts.map +1 -1
  182. package/dist/core/sdk.js +45 -16
  183. package/dist/core/sdk.js.map +1 -1
  184. package/dist/core/session-manager.d.ts +11 -12
  185. package/dist/core/session-manager.d.ts.map +1 -1
  186. package/dist/core/session-manager.js +245 -132
  187. package/dist/core/session-manager.js.map +1 -1
  188. package/dist/core/settings-manager.d.ts +52 -5
  189. package/dist/core/settings-manager.d.ts.map +1 -1
  190. package/dist/core/settings-manager.js +202 -38
  191. package/dist/core/settings-manager.js.map +1 -1
  192. package/dist/core/skills.d.ts +10 -10
  193. package/dist/core/skills.d.ts.map +1 -1
  194. package/dist/core/skills.js +13 -35
  195. package/dist/core/skills.js.map +1 -1
  196. package/dist/core/slash-commands.d.ts +1 -1
  197. package/dist/core/slash-commands.d.ts.map +1 -1
  198. package/dist/core/slash-commands.js +7 -4
  199. package/dist/core/slash-commands.js.map +1 -1
  200. package/dist/core/source-info.d.ts +1 -1
  201. package/dist/core/source-info.d.ts.map +1 -1
  202. package/dist/core/source-info.js.map +1 -1
  203. package/dist/core/system-prompt.d.ts +4 -4
  204. package/dist/core/system-prompt.d.ts.map +1 -1
  205. package/dist/core/system-prompt.js +14 -10
  206. package/dist/core/system-prompt.js.map +1 -1
  207. package/dist/core/telemetry.d.ts +3 -0
  208. package/dist/core/telemetry.d.ts.map +1 -0
  209. package/dist/core/telemetry.js +9 -0
  210. package/dist/core/telemetry.js.map +1 -0
  211. package/dist/core/tools/bash.d.ts +11 -16
  212. package/dist/core/tools/bash.d.ts.map +1 -1
  213. package/dist/core/tools/bash.js +162 -177
  214. package/dist/core/tools/bash.js.map +1 -1
  215. package/dist/core/tools/edit-diff.d.ts +3 -1
  216. package/dist/core/tools/edit-diff.d.ts.map +1 -1
  217. package/dist/core/tools/edit-diff.js +11 -3
  218. package/dist/core/tools/edit-diff.js.map +1 -1
  219. package/dist/core/tools/edit.d.ts +22 -24
  220. package/dist/core/tools/edit.d.ts.map +1 -1
  221. package/dist/core/tools/edit.js +199 -111
  222. package/dist/core/tools/edit.js.map +1 -1
  223. package/dist/core/tools/file-mutation-queue.d.ts.map +1 -1
  224. package/dist/core/tools/file-mutation-queue.js +27 -12
  225. package/dist/core/tools/file-mutation-queue.js.map +1 -1
  226. package/dist/core/tools/find.d.ts +7 -18
  227. package/dist/core/tools/find.d.ts.map +1 -1
  228. package/dist/core/tools/find.js +134 -95
  229. package/dist/core/tools/find.js.map +1 -1
  230. package/dist/core/tools/grep.d.ts +11 -30
  231. package/dist/core/tools/grep.d.ts.map +1 -1
  232. package/dist/core/tools/grep.js +23 -12
  233. package/dist/core/tools/grep.js.map +1 -1
  234. package/dist/core/tools/index.d.ts +26 -101
  235. package/dist/core/tools/index.d.ts.map +1 -1
  236. package/dist/core/tools/index.js +78 -52
  237. package/dist/core/tools/index.js.map +1 -1
  238. package/dist/core/tools/ls.d.ts +6 -15
  239. package/dist/core/tools/ls.d.ts.map +1 -1
  240. package/dist/core/tools/ls.js +12 -17
  241. package/dist/core/tools/ls.js.map +1 -1
  242. package/dist/core/tools/output-accumulator.d.ts +52 -0
  243. package/dist/core/tools/output-accumulator.d.ts.map +1 -0
  244. package/dist/core/tools/output-accumulator.js +184 -0
  245. package/dist/core/tools/output-accumulator.js.map +1 -0
  246. package/dist/core/tools/path-utils.d.ts +2 -0
  247. package/dist/core/tools/path-utils.d.ts.map +1 -1
  248. package/dist/core/tools/path-utils.js +40 -22
  249. package/dist/core/tools/path-utils.js.map +1 -1
  250. package/dist/core/tools/read.d.ts +7 -18
  251. package/dist/core/tools/read.d.ts.map +1 -1
  252. package/dist/core/tools/read.js +100 -36
  253. package/dist/core/tools/read.js.map +1 -1
  254. package/dist/core/tools/render-utils.d.ts +5 -2
  255. package/dist/core/tools/render-utils.d.ts.map +1 -1
  256. package/dist/core/tools/render-utils.js +18 -2
  257. package/dist/core/tools/render-utils.js.map +1 -1
  258. package/dist/core/tools/tool-definition-wrapper.d.ts.map +1 -1
  259. package/dist/core/tools/tool-definition-wrapper.js +2 -0
  260. package/dist/core/tools/tool-definition-wrapper.js.map +1 -1
  261. package/dist/core/tools/truncate.d.ts.map +1 -1
  262. package/dist/core/tools/truncate.js +12 -2
  263. package/dist/core/tools/truncate.js.map +1 -1
  264. package/dist/core/tools/write.d.ts +5 -14
  265. package/dist/core/tools/write.d.ts.map +1 -1
  266. package/dist/core/tools/write.js +27 -46
  267. package/dist/core/tools/write.js.map +1 -1
  268. package/dist/core/trust-manager.d.ts +31 -0
  269. package/dist/core/trust-manager.d.ts.map +1 -0
  270. package/dist/core/trust-manager.js +187 -0
  271. package/dist/core/trust-manager.js.map +1 -0
  272. package/dist/index.d.ts +31 -29
  273. package/dist/index.d.ts.map +1 -1
  274. package/dist/index.js +9 -8
  275. package/dist/index.js.map +1 -1
  276. package/dist/main.d.ts +5 -1
  277. package/dist/main.d.ts.map +1 -1
  278. package/dist/main.js +170 -87
  279. package/dist/main.js.map +1 -1
  280. package/dist/migrations.d.ts +2 -2
  281. package/dist/migrations.d.ts.map +1 -1
  282. package/dist/migrations.js +127 -5
  283. package/dist/migrations.js.map +1 -1
  284. package/dist/modes/index.d.ts +5 -5
  285. package/dist/modes/index.d.ts.map +1 -1
  286. package/dist/modes/index.js.map +1 -1
  287. package/dist/modes/interactive/components/assistant-message.d.ts +2 -0
  288. package/dist/modes/interactive/components/assistant-message.d.ts.map +1 -1
  289. package/dist/modes/interactive/components/assistant-message.js +14 -0
  290. package/dist/modes/interactive/components/assistant-message.js.map +1 -1
  291. package/dist/modes/interactive/components/bash-execution.d.ts +1 -1
  292. package/dist/modes/interactive/components/bash-execution.d.ts.map +1 -1
  293. package/dist/modes/interactive/components/bash-execution.js +3 -3
  294. package/dist/modes/interactive/components/bash-execution.js.map +1 -1
  295. package/dist/modes/interactive/components/bordered-loader.d.ts.map +1 -1
  296. package/dist/modes/interactive/components/bordered-loader.js +3 -0
  297. package/dist/modes/interactive/components/bordered-loader.js.map +1 -1
  298. package/dist/modes/interactive/components/config-selector.d.ts +4 -4
  299. package/dist/modes/interactive/components/config-selector.d.ts.map +1 -1
  300. package/dist/modes/interactive/components/config-selector.js +38 -11
  301. package/dist/modes/interactive/components/config-selector.js.map +1 -1
  302. package/dist/modes/interactive/components/countdown-timer.d.ts +2 -2
  303. package/dist/modes/interactive/components/countdown-timer.d.ts.map +1 -1
  304. package/dist/modes/interactive/components/countdown-timer.js +2 -2
  305. package/dist/modes/interactive/components/countdown-timer.js.map +1 -1
  306. package/dist/modes/interactive/components/custom-editor.d.ts +1 -1
  307. package/dist/modes/interactive/components/custom-editor.d.ts.map +1 -1
  308. package/dist/modes/interactive/components/custom-editor.js.map +1 -1
  309. package/dist/modes/interactive/components/custom-message.d.ts +2 -2
  310. package/dist/modes/interactive/components/custom-message.d.ts.map +1 -1
  311. package/dist/modes/interactive/components/custom-message.js.map +1 -1
  312. package/dist/modes/interactive/components/diff.d.ts.map +1 -1
  313. package/dist/modes/interactive/components/diff.js.map +1 -1
  314. package/dist/modes/interactive/components/earendil-announcement.d.ts.map +1 -1
  315. package/dist/modes/interactive/components/earendil-announcement.js.map +1 -1
  316. package/dist/modes/interactive/components/extension-editor.d.ts.map +1 -1
  317. package/dist/modes/interactive/components/extension-editor.js +14 -6
  318. package/dist/modes/interactive/components/extension-editor.js.map +1 -1
  319. package/dist/modes/interactive/components/extension-input.d.ts.map +1 -1
  320. package/dist/modes/interactive/components/extension-input.js.map +1 -1
  321. package/dist/modes/interactive/components/extension-selector.d.ts +2 -0
  322. package/dist/modes/interactive/components/extension-selector.d.ts.map +1 -1
  323. package/dist/modes/interactive/components/extension-selector.js +8 -3
  324. package/dist/modes/interactive/components/extension-selector.js.map +1 -1
  325. package/dist/modes/interactive/components/first-time-setup.d.ts +25 -0
  326. package/dist/modes/interactive/components/first-time-setup.d.ts.map +1 -0
  327. package/dist/modes/interactive/components/first-time-setup.js +103 -0
  328. package/dist/modes/interactive/components/first-time-setup.js.map +1 -0
  329. package/dist/modes/interactive/components/footer.d.ts +2 -1
  330. package/dist/modes/interactive/components/footer.d.ts.map +1 -1
  331. package/dist/modes/interactive/components/footer.js +23 -7
  332. package/dist/modes/interactive/components/footer.js.map +1 -1
  333. package/dist/modes/interactive/components/index.d.ts +33 -31
  334. package/dist/modes/interactive/components/index.d.ts.map +1 -1
  335. package/dist/modes/interactive/components/index.js +2 -0
  336. package/dist/modes/interactive/components/index.js.map +1 -1
  337. package/dist/modes/interactive/components/keybinding-hints.d.ts +5 -0
  338. package/dist/modes/interactive/components/keybinding-hints.d.ts.map +1 -1
  339. package/dist/modes/interactive/components/keybinding-hints.js +19 -5
  340. package/dist/modes/interactive/components/keybinding-hints.js.map +1 -1
  341. package/dist/modes/interactive/components/login-dialog.d.ts +12 -2
  342. package/dist/modes/interactive/components/login-dialog.d.ts.map +1 -1
  343. package/dist/modes/interactive/components/login-dialog.js +46 -11
  344. package/dist/modes/interactive/components/login-dialog.js.map +1 -1
  345. package/dist/modes/interactive/components/model-selector.d.ts +2 -2
  346. package/dist/modes/interactive/components/model-selector.d.ts.map +1 -1
  347. package/dist/modes/interactive/components/model-selector.js +8 -5
  348. package/dist/modes/interactive/components/model-selector.js.map +1 -1
  349. package/dist/modes/interactive/components/oauth-selector.d.ts +18 -6
  350. package/dist/modes/interactive/components/oauth-selector.d.ts.map +1 -1
  351. package/dist/modes/interactive/components/oauth-selector.js +93 -25
  352. package/dist/modes/interactive/components/oauth-selector.js.map +1 -1
  353. package/dist/modes/interactive/components/scoped-models-selector.d.ts +5 -12
  354. package/dist/modes/interactive/components/scoped-models-selector.d.ts.map +1 -1
  355. package/dist/modes/interactive/components/scoped-models-selector.js +45 -30
  356. package/dist/modes/interactive/components/scoped-models-selector.js.map +1 -1
  357. package/dist/modes/interactive/components/session-selector.d.ts +2 -1
  358. package/dist/modes/interactive/components/session-selector.d.ts.map +1 -1
  359. package/dist/modes/interactive/components/session-selector.js +20 -7
  360. package/dist/modes/interactive/components/session-selector.js.map +1 -1
  361. package/dist/modes/interactive/components/settings-selector.d.ts +13 -0
  362. package/dist/modes/interactive/components/settings-selector.d.ts.map +1 -1
  363. package/dist/modes/interactive/components/settings-selector.js +113 -4
  364. package/dist/modes/interactive/components/settings-selector.js.map +1 -1
  365. package/dist/modes/interactive/components/skill-invocation-message.d.ts +1 -1
  366. package/dist/modes/interactive/components/skill-invocation-message.d.ts.map +1 -1
  367. package/dist/modes/interactive/components/skill-invocation-message.js.map +1 -1
  368. package/dist/modes/interactive/components/thinking-selector.d.ts.map +1 -1
  369. package/dist/modes/interactive/components/thinking-selector.js +1 -1
  370. package/dist/modes/interactive/components/thinking-selector.js.map +1 -1
  371. package/dist/modes/interactive/components/tool-execution.d.ts +6 -1
  372. package/dist/modes/interactive/components/tool-execution.d.ts.map +1 -1
  373. package/dist/modes/interactive/components/tool-execution.js +57 -14
  374. package/dist/modes/interactive/components/tool-execution.js.map +1 -1
  375. package/dist/modes/interactive/components/tree-selector.d.ts.map +1 -1
  376. package/dist/modes/interactive/components/tree-selector.js +18 -9
  377. package/dist/modes/interactive/components/tree-selector.js.map +1 -1
  378. package/dist/modes/interactive/components/trust-selector.d.ts +23 -0
  379. package/dist/modes/interactive/components/trust-selector.d.ts.map +1 -0
  380. package/dist/modes/interactive/components/trust-selector.js +91 -0
  381. package/dist/modes/interactive/components/trust-selector.js.map +1 -0
  382. package/dist/modes/interactive/components/user-message-selector.d.ts +2 -2
  383. package/dist/modes/interactive/components/user-message-selector.d.ts.map +1 -1
  384. package/dist/modes/interactive/components/user-message-selector.js +8 -7
  385. package/dist/modes/interactive/components/user-message-selector.js.map +1 -1
  386. package/dist/modes/interactive/components/user-message.d.ts +1 -0
  387. package/dist/modes/interactive/components/user-message.d.ts.map +1 -1
  388. package/dist/modes/interactive/components/user-message.js +8 -7
  389. package/dist/modes/interactive/components/user-message.js.map +1 -1
  390. package/dist/modes/interactive/interactive-mode.d.ts +68 -13
  391. package/dist/modes/interactive/interactive-mode.d.ts.map +1 -1
  392. package/dist/modes/interactive/interactive-mode.js +1100 -319
  393. package/dist/modes/interactive/interactive-mode.js.map +1 -1
  394. package/dist/modes/interactive/theme/dark.json +5 -4
  395. package/dist/modes/interactive/theme/light.json +5 -4
  396. package/dist/modes/interactive/theme/theme.d.ts +22 -3
  397. package/dist/modes/interactive/theme/theme.d.ts.map +1 -1
  398. package/dist/modes/interactive/theme/theme.js +160 -105
  399. package/dist/modes/interactive/theme/theme.js.map +1 -1
  400. package/dist/modes/print-mode.d.ts.map +1 -1
  401. package/dist/modes/print-mode.js +40 -20
  402. package/dist/modes/print-mode.js.map +1 -1
  403. package/dist/modes/rpc/rpc-client.d.ts +11 -1
  404. package/dist/modes/rpc/rpc-client.d.ts.map +1 -1
  405. package/dist/modes/rpc/rpc-client.js +73 -8
  406. package/dist/modes/rpc/rpc-client.js.map +1 -1
  407. package/dist/modes/rpc/rpc-mode.d.ts +2 -2
  408. package/dist/modes/rpc/rpc-mode.d.ts.map +1 -1
  409. package/dist/modes/rpc/rpc-mode.js +96 -30
  410. package/dist/modes/rpc/rpc-mode.js.map +1 -1
  411. package/dist/modes/rpc/rpc-types.d.ts +16 -4
  412. package/dist/modes/rpc/rpc-types.d.ts.map +1 -1
  413. package/dist/modes/rpc/rpc-types.js.map +1 -1
  414. package/dist/package-manager-cli.d.ts +6 -2
  415. package/dist/package-manager-cli.d.ts.map +1 -1
  416. package/dist/package-manager-cli.js +396 -21
  417. package/dist/package-manager-cli.js.map +1 -1
  418. package/dist/prompts/commands/atomic-commit.md +12 -0
  419. package/dist/prompts/commands/execute-phase.md +48 -17
  420. package/dist/prompts/commands/fix.md +86 -23
  421. package/dist/prompts/commands/map-codebase.md +17 -3
  422. package/dist/prompts/commands/orchestrate.md +31 -6
  423. package/dist/prompts/commands/plan-phase.md +39 -6
  424. package/dist/prompts/commands/quick.md +36 -6
  425. package/dist/prompts/commands/review.md +28 -11
  426. package/dist/prompts/commands/verify-work.md +34 -17
  427. package/dist/utils/ansi.d.ts +2 -0
  428. package/dist/utils/ansi.d.ts.map +1 -0
  429. package/dist/utils/ansi.js +52 -0
  430. package/dist/utils/ansi.js.map +1 -0
  431. package/dist/utils/changelog.d.ts +2 -1
  432. package/dist/utils/changelog.d.ts.map +1 -1
  433. package/dist/utils/changelog.js +78 -0
  434. package/dist/utils/changelog.js.map +1 -1
  435. package/dist/utils/child-process.d.ts +5 -1
  436. package/dist/utils/child-process.d.ts.map +1 -1
  437. package/dist/utils/child-process.js +10 -0
  438. package/dist/utils/child-process.js.map +1 -1
  439. package/dist/utils/clipboard-image.d.ts.map +1 -1
  440. package/dist/utils/clipboard-image.js +2 -2
  441. package/dist/utils/clipboard-image.js.map +1 -1
  442. package/dist/utils/clipboard-native.d.ts +3 -1
  443. package/dist/utils/clipboard-native.d.ts.map +1 -1
  444. package/dist/utils/clipboard-native.js +14 -8
  445. package/dist/utils/clipboard-native.js.map +1 -1
  446. package/dist/utils/clipboard.d.ts.map +1 -1
  447. package/dist/utils/clipboard.js +84 -45
  448. package/dist/utils/clipboard.js.map +1 -1
  449. package/dist/utils/deprecation.d.ts +4 -0
  450. package/dist/utils/deprecation.d.ts.map +1 -0
  451. package/dist/utils/deprecation.js +13 -0
  452. package/dist/utils/deprecation.js.map +1 -0
  453. package/dist/utils/exif-orientation.d.ts +1 -1
  454. package/dist/utils/exif-orientation.d.ts.map +1 -1
  455. package/dist/utils/exif-orientation.js.map +1 -1
  456. package/dist/utils/fs-watch.d.ts +5 -0
  457. package/dist/utils/fs-watch.d.ts.map +1 -0
  458. package/dist/utils/fs-watch.js +25 -0
  459. package/dist/utils/fs-watch.js.map +1 -0
  460. package/dist/utils/git.d.ts.map +1 -1
  461. package/dist/utils/git.js +54 -22
  462. package/dist/utils/git.js.map +1 -1
  463. package/dist/utils/html.d.ts +7 -0
  464. package/dist/utils/html.d.ts.map +1 -0
  465. package/dist/utils/html.js +40 -0
  466. package/dist/utils/html.js.map +1 -0
  467. package/dist/utils/image-convert.d.ts.map +1 -1
  468. package/dist/utils/image-convert.js.map +1 -1
  469. package/dist/utils/image-resize-core.d.ts +30 -0
  470. package/dist/utils/image-resize-core.d.ts.map +1 -0
  471. package/dist/utils/image-resize-core.js +124 -0
  472. package/dist/utils/image-resize-core.js.map +1 -0
  473. package/dist/utils/image-resize-worker.d.ts +2 -0
  474. package/dist/utils/image-resize-worker.d.ts.map +1 -0
  475. package/dist/utils/image-resize-worker.js +31 -0
  476. package/dist/utils/image-resize-worker.js.map +1 -0
  477. package/dist/utils/image-resize.d.ts +7 -27
  478. package/dist/utils/image-resize.d.ts.map +1 -1
  479. package/dist/utils/image-resize.js +75 -115
  480. package/dist/utils/image-resize.js.map +1 -1
  481. package/dist/utils/json.d.ts +3 -0
  482. package/dist/utils/json.d.ts.map +1 -0
  483. package/dist/utils/json.js +7 -0
  484. package/dist/utils/json.js.map +1 -0
  485. package/dist/utils/mime.d.ts +1 -0
  486. package/dist/utils/mime.d.ts.map +1 -1
  487. package/dist/utils/mime.js +59 -16
  488. package/dist/utils/mime.js.map +1 -1
  489. package/dist/utils/open-browser.d.ts +9 -0
  490. package/dist/utils/open-browser.d.ts.map +1 -0
  491. package/dist/utils/open-browser.js +22 -0
  492. package/dist/utils/open-browser.js.map +1 -0
  493. package/dist/utils/paths.d.ts +25 -1
  494. package/dist/utils/paths.d.ts.map +1 -1
  495. package/dist/utils/paths.js +75 -2
  496. package/dist/utils/paths.js.map +1 -1
  497. package/dist/utils/pi-user-agent.d.ts +2 -0
  498. package/dist/utils/pi-user-agent.d.ts.map +1 -0
  499. package/dist/utils/pi-user-agent.js +5 -0
  500. package/dist/utils/pi-user-agent.js.map +1 -0
  501. package/dist/utils/shell.d.ts +10 -6
  502. package/dist/utils/shell.d.ts.map +1 -1
  503. package/dist/utils/shell.js +35 -26
  504. package/dist/utils/shell.js.map +1 -1
  505. package/dist/utils/syntax-highlight.d.ts +12 -0
  506. package/dist/utils/syntax-highlight.d.ts.map +1 -0
  507. package/dist/utils/syntax-highlight.js +118 -0
  508. package/dist/utils/syntax-highlight.js.map +1 -0
  509. package/dist/utils/tools-manager.d.ts.map +1 -1
  510. package/dist/utils/tools-manager.js +86 -10
  511. package/dist/utils/tools-manager.js.map +1 -1
  512. package/dist/utils/version-check.d.ts +15 -0
  513. package/dist/utils/version-check.d.ts.map +1 -0
  514. package/dist/utils/version-check.js +82 -0
  515. package/dist/utils/version-check.js.map +1 -0
  516. package/dist/utils/windows-self-update.d.ts +3 -0
  517. package/dist/utils/windows-self-update.d.ts.map +1 -0
  518. package/dist/utils/windows-self-update.js +77 -0
  519. package/dist/utils/windows-self-update.js.map +1 -0
  520. package/docs/compaction.md +12 -12
  521. package/docs/containerization.md +111 -0
  522. package/docs/custom-provider.md +187 -47
  523. package/docs/development.md +5 -5
  524. package/docs/docs.json +156 -0
  525. package/docs/extensions.md +465 -71
  526. package/docs/index.md +82 -0
  527. package/docs/json.md +4 -4
  528. package/docs/keybindings.md +23 -1
  529. package/docs/models.md +119 -17
  530. package/docs/packages.md +17 -9
  531. package/docs/prompt-templates.md +30 -2
  532. package/docs/providers.md +83 -22
  533. package/docs/quickstart.md +165 -0
  534. package/docs/rpc.md +41 -10
  535. package/docs/sdk.md +68 -50
  536. package/docs/security.md +55 -0
  537. package/docs/{session.md → session-format.md} +11 -11
  538. package/docs/sessions.md +145 -0
  539. package/docs/settings.md +61 -11
  540. package/docs/skills.md +16 -17
  541. package/docs/terminal-setup.md +44 -2
  542. package/docs/termux.md +4 -4
  543. package/docs/themes.md +3 -3
  544. package/docs/tmux.md +4 -2
  545. package/docs/tui.md +44 -4
  546. package/docs/usage.md +305 -0
  547. package/examples/extensions/border-status-editor.ts +145 -0
  548. package/examples/extensions/built-in-tool-renderer.ts +3 -0
  549. package/examples/extensions/custom-header.ts +1 -1
  550. package/examples/extensions/custom-provider-anthropic/index.ts +1 -1
  551. package/examples/extensions/custom-provider-anthropic/package-lock.json +2 -2
  552. package/examples/extensions/custom-provider-anthropic/package.json +2 -2
  553. package/examples/extensions/custom-provider-gitlab-duo/index.ts +55 -4
  554. package/examples/extensions/custom-provider-gitlab-duo/package.json +1 -1
  555. package/examples/extensions/custom-provider-gitlab-duo/test.ts +1 -1
  556. package/examples/extensions/doom-overlay/doom-component.ts +2 -2
  557. package/examples/extensions/doom-overlay/index.ts +1 -1
  558. package/examples/extensions/dynamic-resources/dynamic.json +1 -1
  559. package/examples/extensions/dynamic-tools.ts +2 -2
  560. package/examples/extensions/git-merge-and-resolve.ts +115 -0
  561. package/examples/extensions/github-issue-autocomplete.ts +185 -0
  562. package/examples/extensions/gondolin/index.ts +531 -0
  563. package/examples/extensions/gondolin/package-lock.json +185 -0
  564. package/examples/extensions/gondolin/package.json +19 -0
  565. package/examples/extensions/handoff.ts +50 -12
  566. package/examples/extensions/input-transform-streaming.ts +39 -0
  567. package/examples/extensions/interactive-shell.ts +1 -1
  568. package/examples/extensions/notify.ts +2 -9
  569. package/examples/extensions/overlay-qa-tests.ts +240 -138
  570. package/examples/extensions/overlay-test.ts +7 -4
  571. package/examples/extensions/plan-mode/utils.ts +1 -1
  572. package/examples/extensions/preset.ts +36 -3
  573. package/examples/extensions/project-trust.ts +64 -0
  574. package/examples/extensions/prompt-customizer.ts +97 -0
  575. package/examples/extensions/provider-payload.ts +4 -0
  576. package/examples/extensions/qna.ts +1 -1
  577. package/examples/extensions/question.ts +2 -2
  578. package/examples/extensions/questionnaire.ts +2 -2
  579. package/examples/extensions/reload-runtime.ts +1 -1
  580. package/examples/extensions/sandbox/index.ts +4 -4
  581. package/examples/extensions/sandbox/package-lock.json +5 -5
  582. package/examples/extensions/sandbox/package.json +2 -2
  583. package/examples/extensions/shutdown-command.ts +1 -1
  584. package/examples/extensions/snake.ts +1 -1
  585. package/examples/extensions/space-invaders.ts +1 -1
  586. package/examples/extensions/structured-output.ts +65 -0
  587. package/examples/extensions/subagent/index.ts +51 -28
  588. package/examples/extensions/summarize.ts +1 -1
  589. package/examples/extensions/tic-tac-toe.ts +1008 -0
  590. package/examples/extensions/titlebar-spinner.ts +2 -2
  591. package/examples/extensions/todo.ts +2 -2
  592. package/examples/extensions/tool-override.ts +1 -1
  593. package/examples/extensions/tools.ts +5 -0
  594. package/examples/extensions/truncated-tool.ts +1 -1
  595. package/examples/extensions/with-deps/index.ts +1 -1
  596. package/examples/extensions/with-deps/package-lock.json +2 -2
  597. package/examples/extensions/with-deps/package.json +3 -3
  598. package/examples/extensions/working-indicator.ts +123 -0
  599. package/examples/extensions/working-message-test.ts +25 -0
  600. package/examples/sdk/01-minimal.ts +14 -10
  601. package/examples/sdk/02-custom-model.ts +12 -8
  602. package/examples/sdk/03-custom-prompt.ts +32 -17
  603. package/examples/sdk/04-skills.ts +5 -2
  604. package/examples/sdk/05-tools.ts +23 -31
  605. package/examples/sdk/06-extensions.ts +14 -8
  606. package/examples/sdk/07-context-files.ts +5 -3
  607. package/examples/sdk/08-prompt-templates.ts +5 -2
  608. package/examples/sdk/09-api-keys-and-oauth.ts +8 -4
  609. package/examples/sdk/10-settings.ts +8 -6
  610. package/examples/sdk/11-sessions.ts +4 -0
  611. package/examples/sdk/12-full-control.ts +13 -17
  612. package/package.json +15 -7
  613. package/prompts/commands/atomic-commit.md +12 -0
  614. package/prompts/commands/execute-phase.md +48 -17
  615. package/prompts/commands/fix.md +86 -23
  616. package/prompts/commands/map-codebase.md +17 -3
  617. package/prompts/commands/orchestrate.md +31 -6
  618. package/prompts/commands/plan-phase.md +39 -6
  619. package/prompts/commands/quick.md +36 -6
  620. package/prompts/commands/review.md +28 -11
  621. package/prompts/commands/verify-work.md +34 -17
@@ -1,10 +1,22 @@
1
+ import { uuidv7 } from "@draht/agent-core";
1
2
  import { randomUUID } from "crypto";
2
- import { appendFileSync, closeSync, existsSync, mkdirSync, openSync, readdirSync, readFileSync, readSync, statSync, writeFileSync, } from "fs";
3
- import { readdir, readFile, stat } from "fs/promises";
3
+ import { appendFileSync, closeSync, createReadStream, existsSync, mkdirSync, openSync, readdirSync, readSync, statSync, writeFileSync, } from "fs";
4
+ import { readdir, stat } from "fs/promises";
4
5
  import { join, resolve } from "path";
6
+ import { createInterface } from "readline";
7
+ import { StringDecoder } from "string_decoder";
5
8
  import { getAgentDir as getDefaultAgentDir, getSessionsDir } from "../config.js";
9
+ import { normalizePath, resolvePath } from "../utils/paths.js";
6
10
  import { createBranchSummaryMessage, createCompactionSummaryMessage, createCustomMessage, } from "./messages.js";
7
11
  export const CURRENT_SESSION_VERSION = 3;
12
+ function createSessionId() {
13
+ return uuidv7();
14
+ }
15
+ export function assertValidSessionId(id) {
16
+ if (!/^[A-Za-z0-9](?:[A-Za-z0-9._-]*[A-Za-z0-9])?$/.test(id)) {
17
+ throw new Error("Session id must be non-empty, contain only alphanumeric characters, '-', '_', and '.', and start and end with an alphanumeric character");
18
+ }
19
+ }
8
20
  /** Generate a unique short ID (8 hex chars, collision-checked) */
9
21
  function generateId(byId) {
10
22
  for (let i = 0; i < 100; i++) {
@@ -203,33 +215,67 @@ export function buildSessionContext(entries, leafId, byId) {
203
215
  }
204
216
  /**
205
217
  * Compute the default session directory for a cwd.
206
- * Encodes cwd into a safe directory name under ~/.draht/agent/sessions/.
218
+ * Encodes cwd into a safe directory name under ~/.pi/agent/sessions/.
207
219
  */
220
+ function getDefaultSessionDirPath(cwd, agentDir = getDefaultAgentDir()) {
221
+ const resolvedCwd = resolvePath(cwd);
222
+ const resolvedAgentDir = resolvePath(agentDir);
223
+ const safePath = `--${resolvedCwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
224
+ return join(resolvedAgentDir, "sessions", safePath);
225
+ }
208
226
  export function getDefaultSessionDir(cwd, agentDir = getDefaultAgentDir()) {
209
- const safePath = `--${cwd.replace(/^[/\\]/, "").replace(/[/\\:]/g, "-")}--`;
210
- const sessionDir = join(agentDir, "sessions", safePath);
227
+ const sessionDir = getDefaultSessionDirPath(cwd, agentDir);
211
228
  if (!existsSync(sessionDir)) {
212
229
  mkdirSync(sessionDir, { recursive: true });
213
230
  }
214
231
  return sessionDir;
215
232
  }
233
+ const SESSION_READ_BUFFER_SIZE = 1024 * 1024;
234
+ function parseSessionEntryLine(line) {
235
+ if (!line.trim())
236
+ return null;
237
+ try {
238
+ return JSON.parse(line);
239
+ }
240
+ catch {
241
+ // Skip malformed lines
242
+ return null;
243
+ }
244
+ }
216
245
  /** Exported for testing */
217
246
  export function loadEntriesFromFile(filePath) {
218
- if (!existsSync(filePath))
247
+ const resolvedFilePath = normalizePath(filePath);
248
+ if (!existsSync(resolvedFilePath))
219
249
  return [];
220
- const content = readFileSync(filePath, "utf8");
221
250
  const entries = [];
222
- const lines = content.trim().split("\n");
223
- for (const line of lines) {
224
- if (!line.trim())
225
- continue;
226
- try {
227
- const entry = JSON.parse(line);
228
- entries.push(entry);
229
- }
230
- catch {
231
- // Skip malformed lines
251
+ const fd = openSync(resolvedFilePath, "r");
252
+ try {
253
+ const decoder = new StringDecoder("utf8");
254
+ const buffer = Buffer.allocUnsafe(SESSION_READ_BUFFER_SIZE);
255
+ let pending = "";
256
+ while (true) {
257
+ const bytesRead = readSync(fd, buffer, 0, buffer.length, null);
258
+ if (bytesRead === 0)
259
+ break;
260
+ pending += decoder.write(buffer.subarray(0, bytesRead));
261
+ let lineStart = 0;
262
+ let newlineIndex = pending.indexOf("\n", lineStart);
263
+ while (newlineIndex !== -1) {
264
+ const entry = parseSessionEntryLine(pending.slice(lineStart, newlineIndex));
265
+ if (entry)
266
+ entries.push(entry);
267
+ lineStart = newlineIndex + 1;
268
+ newlineIndex = pending.indexOf("\n", lineStart);
269
+ }
270
+ pending = pending.slice(lineStart);
232
271
  }
272
+ pending += decoder.end();
273
+ const finalEntry = parseSessionEntryLine(pending);
274
+ if (finalEntry)
275
+ entries.push(finalEntry);
276
+ }
277
+ finally {
278
+ closeSync(fd);
233
279
  }
234
280
  // Validate session header
235
281
  if (entries.length === 0)
@@ -240,7 +286,7 @@ export function loadEntriesFromFile(filePath) {
240
286
  }
241
287
  return entries;
242
288
  }
243
- function isValidSessionFile(filePath) {
289
+ function readSessionHeader(filePath) {
244
290
  try {
245
291
  const fd = openSync(filePath, "r");
246
292
  const buffer = Buffer.alloc(512);
@@ -248,22 +294,36 @@ function isValidSessionFile(filePath) {
248
294
  closeSync(fd);
249
295
  const firstLine = buffer.toString("utf8", 0, bytesRead).split("\n")[0];
250
296
  if (!firstLine)
251
- return false;
297
+ return null;
252
298
  const header = JSON.parse(firstLine);
253
- return header.type === "session" && typeof header.id === "string";
299
+ if (header.type !== "session" || typeof header.id !== "string") {
300
+ return null;
301
+ }
302
+ return header;
254
303
  }
255
304
  catch {
256
- return false;
305
+ return null;
257
306
  }
258
307
  }
308
+ function getSessionHeaderCwd(header) {
309
+ const cwd = header.cwd;
310
+ return typeof cwd === "string" ? cwd : undefined;
311
+ }
312
+ function sessionCwdMatches(cwd, resolvedCwd) {
313
+ return cwd !== undefined && cwd !== "" && resolvePath(cwd) === resolvedCwd;
314
+ }
259
315
  /** Exported for testing */
260
- export function findMostRecentSession(sessionDir) {
316
+ export function findMostRecentSession(sessionDir, cwd) {
317
+ const resolvedSessionDir = normalizePath(sessionDir);
318
+ const resolvedCwd = cwd ? resolvePath(cwd) : undefined;
261
319
  try {
262
- const files = readdirSync(sessionDir)
320
+ const files = readdirSync(resolvedSessionDir)
263
321
  .filter((f) => f.endsWith(".jsonl"))
264
- .map((f) => join(sessionDir, f))
265
- .filter(isValidSessionFile)
266
- .map((path) => ({ path, mtime: statSync(path).mtime }))
322
+ .map((f) => join(resolvedSessionDir, f))
323
+ .map((path) => ({ path, header: readSessionHeader(path) }))
324
+ .filter((file) => file.header !== null &&
325
+ (!resolvedCwd || sessionCwdMatches(getSessionHeaderCwd(file.header), resolvedCwd)))
326
+ .map(({ path }) => ({ path, mtime: statSync(path).mtime }))
267
327
  .sort((a, b) => b.mtime.getTime() - a.mtime.getTime());
268
328
  return files[0]?.path || null;
269
329
  }
@@ -284,73 +344,53 @@ function extractTextContent(message) {
284
344
  .map((block) => block.text)
285
345
  .join(" ");
286
346
  }
287
- function getLastActivityTime(entries) {
288
- let lastActivityTime;
289
- for (const entry of entries) {
290
- if (entry.type !== "message")
291
- continue;
292
- const message = entry.message;
293
- if (!isMessageWithContent(message))
294
- continue;
295
- if (message.role !== "user" && message.role !== "assistant")
296
- continue;
297
- const msgTimestamp = message.timestamp;
298
- if (typeof msgTimestamp === "number") {
299
- lastActivityTime = Math.max(lastActivityTime ?? 0, msgTimestamp);
300
- continue;
301
- }
302
- const entryTimestamp = entry.timestamp;
303
- if (typeof entryTimestamp === "string") {
304
- const t = new Date(entryTimestamp).getTime();
305
- if (!Number.isNaN(t)) {
306
- lastActivityTime = Math.max(lastActivityTime ?? 0, t);
307
- }
308
- }
309
- }
310
- return lastActivityTime;
311
- }
312
- function getSessionModifiedDate(entries, header, statsMtime) {
313
- const lastActivityTime = getLastActivityTime(entries);
314
- if (typeof lastActivityTime === "number" && lastActivityTime > 0) {
315
- return new Date(lastActivityTime);
347
+ function getMessageActivityTime(entry) {
348
+ const message = entry.message;
349
+ if (!isMessageWithContent(message))
350
+ return undefined;
351
+ if (message.role !== "user" && message.role !== "assistant")
352
+ return undefined;
353
+ const msgTimestamp = message.timestamp;
354
+ if (typeof msgTimestamp === "number") {
355
+ return msgTimestamp;
316
356
  }
317
- const headerTime = typeof header.timestamp === "string" ? new Date(header.timestamp).getTime() : NaN;
318
- return !Number.isNaN(headerTime) ? new Date(headerTime) : statsMtime;
357
+ const t = new Date(entry.timestamp).getTime();
358
+ return Number.isNaN(t) ? undefined : t;
319
359
  }
320
360
  async function buildSessionInfo(filePath) {
321
361
  try {
322
- const content = await readFile(filePath, "utf8");
323
- const entries = [];
324
- const lines = content.trim().split("\n");
325
- for (const line of lines) {
326
- if (!line.trim())
327
- continue;
328
- try {
329
- entries.push(JSON.parse(line));
330
- }
331
- catch {
332
- // Skip malformed lines
333
- }
334
- }
335
- if (entries.length === 0)
336
- return null;
337
- const header = entries[0];
338
- if (header.type !== "session")
339
- return null;
340
362
  const stats = await stat(filePath);
363
+ let header = null;
341
364
  let messageCount = 0;
342
365
  let firstMessage = "";
343
366
  const allMessages = [];
344
367
  let name;
345
- for (const entry of entries) {
368
+ let lastActivityTime;
369
+ const rl = createInterface({
370
+ input: createReadStream(filePath, { encoding: "utf8" }),
371
+ crlfDelay: Infinity,
372
+ });
373
+ for await (const line of rl) {
374
+ const entry = parseSessionEntryLine(line);
375
+ if (!entry)
376
+ continue;
377
+ if (!header) {
378
+ if (entry.type !== "session")
379
+ return null;
380
+ header = entry;
381
+ continue;
382
+ }
346
383
  // Extract session name (use latest, including explicit clears)
347
384
  if (entry.type === "session_info") {
348
- const infoEntry = entry;
349
- name = infoEntry.name?.trim() || undefined;
385
+ name = entry.name?.trim() || undefined;
350
386
  }
351
387
  if (entry.type !== "message")
352
388
  continue;
353
389
  messageCount++;
390
+ const activityTime = getMessageActivityTime(entry);
391
+ if (typeof activityTime === "number") {
392
+ lastActivityTime = Math.max(lastActivityTime ?? 0, activityTime);
393
+ }
354
394
  const message = entry.message;
355
395
  if (!isMessageWithContent(message))
356
396
  continue;
@@ -364,9 +404,16 @@ async function buildSessionInfo(filePath) {
364
404
  firstMessage = textContent;
365
405
  }
366
406
  }
407
+ if (!header)
408
+ return null;
367
409
  const cwd = typeof header.cwd === "string" ? header.cwd : "";
368
410
  const parentSessionPath = header.parentSession;
369
- const modified = getSessionModifiedDate(entries, header, stats.mtime);
411
+ const headerTime = typeof header.timestamp === "string" ? new Date(header.timestamp).getTime() : NaN;
412
+ const modified = typeof lastActivityTime === "number" && lastActivityTime > 0
413
+ ? new Date(lastActivityTime)
414
+ : !Number.isNaN(headerTime)
415
+ ? new Date(headerTime)
416
+ : stats.mtime;
370
417
  return {
371
418
  path: filePath,
372
419
  id: header.id,
@@ -384,6 +431,40 @@ async function buildSessionInfo(filePath) {
384
431
  return null;
385
432
  }
386
433
  }
434
+ const MAX_CONCURRENT_SESSION_INFO_LOADS = 10;
435
+ async function buildSessionInfosWithConcurrency(files, onLoaded) {
436
+ const results = new Array(files.length).fill(null);
437
+ const inFlight = new Set();
438
+ let nextIndex = 0;
439
+ const startNext = () => {
440
+ const index = nextIndex++;
441
+ const file = files[index];
442
+ if (!file)
443
+ return;
444
+ let task;
445
+ task = buildSessionInfo(file)
446
+ .then((info) => {
447
+ results[index] = info;
448
+ })
449
+ .catch(() => {
450
+ results[index] = null;
451
+ })
452
+ .finally(() => {
453
+ inFlight.delete(task);
454
+ onLoaded();
455
+ });
456
+ inFlight.add(task);
457
+ };
458
+ while (nextIndex < files.length || inFlight.size > 0) {
459
+ while (nextIndex < files.length && inFlight.size < MAX_CONCURRENT_SESSION_INFO_LOADS) {
460
+ startNext();
461
+ }
462
+ if (inFlight.size > 0) {
463
+ await Promise.race(inFlight);
464
+ }
465
+ }
466
+ return results;
467
+ }
387
468
  async function listSessionsFromDir(dir, onProgress, progressOffset = 0, progressTotal) {
388
469
  const sessions = [];
389
470
  if (!existsSync(dir)) {
@@ -394,12 +475,10 @@ async function listSessionsFromDir(dir, onProgress, progressOffset = 0, progress
394
475
  const files = dirEntries.filter((f) => f.endsWith(".jsonl")).map((f) => join(dir, f));
395
476
  const total = progressTotal ?? files.length;
396
477
  let loaded = 0;
397
- const results = await Promise.all(files.map(async (file) => {
398
- const info = await buildSessionInfo(file);
478
+ const results = await buildSessionInfosWithConcurrency(files, () => {
399
479
  loaded++;
400
480
  onProgress?.(progressOffset + loaded, total);
401
- return info;
402
- }));
481
+ });
403
482
  for (const info of results) {
404
483
  if (info) {
405
484
  sessions.push(info);
@@ -434,23 +513,23 @@ export class SessionManager {
434
513
  labelsById = new Map();
435
514
  labelTimestampsById = new Map();
436
515
  leafId = null;
437
- constructor(cwd, sessionDir, sessionFile, persist) {
438
- this.cwd = cwd;
439
- this.sessionDir = sessionDir;
516
+ constructor(cwd, sessionDir, sessionFile, persist, newSessionOptions) {
517
+ this.cwd = resolvePath(cwd);
518
+ this.sessionDir = normalizePath(sessionDir);
440
519
  this.persist = persist;
441
- if (persist && sessionDir && !existsSync(sessionDir)) {
442
- mkdirSync(sessionDir, { recursive: true });
520
+ if (persist && this.sessionDir && !existsSync(this.sessionDir)) {
521
+ mkdirSync(this.sessionDir, { recursive: true });
443
522
  }
444
523
  if (sessionFile) {
445
524
  this.setSessionFile(sessionFile);
446
525
  }
447
526
  else {
448
- this.newSession();
527
+ this.newSession(newSessionOptions);
449
528
  }
450
529
  }
451
530
  /** Switch to a different session file (used for resume and branching) */
452
531
  setSessionFile(sessionFile) {
453
- this.sessionFile = resolve(sessionFile);
532
+ this.sessionFile = resolvePath(sessionFile);
454
533
  if (existsSync(this.sessionFile)) {
455
534
  this.fileEntries = loadEntriesFromFile(this.sessionFile);
456
535
  // If file was empty or corrupted (no valid header), truncate and start fresh
@@ -464,7 +543,7 @@ export class SessionManager {
464
543
  return;
465
544
  }
466
545
  const header = this.fileEntries.find((e) => e.type === "session");
467
- this.sessionId = header?.id ?? randomUUID();
546
+ this.sessionId = header?.id ?? createSessionId();
468
547
  if (migrateToCurrentVersion(this.fileEntries)) {
469
548
  this._rewriteFile();
470
549
  }
@@ -478,7 +557,10 @@ export class SessionManager {
478
557
  }
479
558
  }
480
559
  newSession(options) {
481
- this.sessionId = options?.id ?? randomUUID();
560
+ if (options?.id !== undefined) {
561
+ assertValidSessionId(options.id);
562
+ }
563
+ this.sessionId = options?.id ?? createSessionId();
482
564
  const timestamp = new Date().toISOString();
483
565
  const header = {
484
566
  type: "session",
@@ -524,8 +606,15 @@ export class SessionManager {
524
606
  _rewriteFile() {
525
607
  if (!this.persist || !this.sessionFile)
526
608
  return;
527
- const content = `${this.fileEntries.map((e) => JSON.stringify(e)).join("\n")}\n`;
528
- writeFileSync(this.sessionFile, content);
609
+ const fd = openSync(this.sessionFile, "w");
610
+ try {
611
+ for (const entry of this.fileEntries) {
612
+ writeFileSync(fd, `${JSON.stringify(entry)}\n`);
613
+ }
614
+ }
615
+ finally {
616
+ closeSync(fd);
617
+ }
529
618
  }
530
619
  isPersisted() {
531
620
  return this.persist;
@@ -536,6 +625,9 @@ export class SessionManager {
536
625
  getSessionDir() {
537
626
  return this.sessionDir;
538
627
  }
628
+ usesDefaultSessionDir() {
629
+ return this.sessionDir === getDefaultSessionDirPath(this.cwd);
630
+ }
539
631
  getSessionId() {
540
632
  return this.sessionId;
541
633
  }
@@ -547,13 +639,24 @@ export class SessionManager {
547
639
  return;
548
640
  const hasAssistant = this.fileEntries.some((e) => e.type === "message" && e.message.role === "assistant");
549
641
  if (!hasAssistant) {
550
- // Mark as not flushed so when assistant arrives, all entries get written
551
- this.flushed = false;
642
+ if (this.flushed) {
643
+ appendFileSync(this.sessionFile, `${JSON.stringify(entry)}\n`);
644
+ }
645
+ else {
646
+ // Mark as not flushed so when assistant arrives, all entries get written
647
+ this.flushed = false;
648
+ }
552
649
  return;
553
650
  }
554
651
  if (!this.flushed) {
555
- for (const e of this.fileEntries) {
556
- appendFileSync(this.sessionFile, `${JSON.stringify(e)}\n`);
652
+ const fd = openSync(this.sessionFile, "wx");
653
+ try {
654
+ for (const e of this.fileEntries) {
655
+ writeFileSync(fd, `${JSON.stringify(e)}\n`);
656
+ }
657
+ }
658
+ finally {
659
+ closeSync(fd);
557
660
  }
558
661
  this.flushed = true;
559
662
  }
@@ -881,7 +984,7 @@ export class SessionManager {
881
984
  }
882
985
  // Filter out LabelEntry from path - we'll recreate them from the resolved map
883
986
  const pathWithoutLabels = path.filter((e) => e.type !== "label");
884
- const newSessionId = randomUUID();
987
+ const newSessionId = createSessionId();
885
988
  const timestamp = new Date().toISOString();
886
989
  const fileTimestamp = timestamp.replace(/[:.]/g, "-");
887
990
  const newSessionFile = join(this.getSessionDir(), `${fileTimestamp}_${newSessionId}.jsonl`);
@@ -961,11 +1064,11 @@ export class SessionManager {
961
1064
  /**
962
1065
  * Create a new session.
963
1066
  * @param cwd Working directory (stored in session header)
964
- * @param sessionDir Optional session directory. If omitted, uses default (~/.draht/agent/sessions/<encoded-cwd>/).
1067
+ * @param sessionDir Optional session directory. If omitted, uses default (~/.pi/agent/sessions/<encoded-cwd>/).
965
1068
  */
966
- static create(cwd, sessionDir) {
967
- const dir = sessionDir ?? getDefaultSessionDir(cwd);
968
- return new SessionManager(cwd, dir, undefined, true);
1069
+ static create(cwd, sessionDir, options) {
1070
+ const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);
1071
+ return new SessionManager(cwd, dir, undefined, true, options);
969
1072
  }
970
1073
  /**
971
1074
  * Open a specific session file.
@@ -974,22 +1077,24 @@ export class SessionManager {
974
1077
  * @param cwdOverride Optional cwd override instead of the session header cwd.
975
1078
  */
976
1079
  static open(path, sessionDir, cwdOverride) {
1080
+ const resolvedPath = resolvePath(path);
977
1081
  // Extract cwd from session header if possible, otherwise use process.cwd()
978
- const entries = loadEntriesFromFile(path);
1082
+ const entries = loadEntriesFromFile(resolvedPath);
979
1083
  const header = entries.find((e) => e.type === "session");
980
1084
  const cwd = cwdOverride ?? header?.cwd ?? process.cwd();
981
1085
  // If no sessionDir provided, derive from file's parent directory
982
- const dir = sessionDir ?? resolve(path, "..");
983
- return new SessionManager(cwd, dir, path, true);
1086
+ const dir = sessionDir ? normalizePath(sessionDir) : resolve(resolvedPath, "..");
1087
+ return new SessionManager(cwd, dir, resolvedPath, true);
984
1088
  }
985
1089
  /**
986
1090
  * Continue the most recent session, or create new if none.
987
1091
  * @param cwd Working directory
988
- * @param sessionDir Optional session directory. If omitted, uses default (~/.draht/agent/sessions/<encoded-cwd>/).
1092
+ * @param sessionDir Optional session directory. If omitted, uses default (~/.pi/agent/sessions/<encoded-cwd>/).
989
1093
  */
990
1094
  static continueRecent(cwd, sessionDir) {
991
- const dir = sessionDir ?? getDefaultSessionDir(cwd);
992
- const mostRecent = findMostRecentSession(dir);
1095
+ const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);
1096
+ const filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);
1097
+ const mostRecent = findMostRecentSession(dir, filterCwd ? cwd : undefined);
993
1098
  if (mostRecent) {
994
1099
  return new SessionManager(cwd, dir, mostRecent, true);
995
1100
  }
@@ -1006,21 +1111,26 @@ export class SessionManager {
1006
1111
  * @param targetCwd Target working directory (where the new session will be stored)
1007
1112
  * @param sessionDir Optional session directory. If omitted, uses default for targetCwd.
1008
1113
  */
1009
- static forkFrom(sourcePath, targetCwd, sessionDir) {
1010
- const sourceEntries = loadEntriesFromFile(sourcePath);
1114
+ static forkFrom(sourcePath, targetCwd, sessionDir, options) {
1115
+ const resolvedSourcePath = resolvePath(sourcePath);
1116
+ const resolvedTargetCwd = resolvePath(targetCwd);
1117
+ const sourceEntries = loadEntriesFromFile(resolvedSourcePath);
1011
1118
  if (sourceEntries.length === 0) {
1012
- throw new Error(`Cannot fork: source session file is empty or invalid: ${sourcePath}`);
1119
+ throw new Error(`Cannot fork: source session file is empty or invalid: ${resolvedSourcePath}`);
1013
1120
  }
1014
1121
  const sourceHeader = sourceEntries.find((e) => e.type === "session");
1015
1122
  if (!sourceHeader) {
1016
- throw new Error(`Cannot fork: source session has no header: ${sourcePath}`);
1123
+ throw new Error(`Cannot fork: source session has no header: ${resolvedSourcePath}`);
1017
1124
  }
1018
- const dir = sessionDir ?? getDefaultSessionDir(targetCwd);
1125
+ const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(resolvedTargetCwd);
1019
1126
  if (!existsSync(dir)) {
1020
1127
  mkdirSync(dir, { recursive: true });
1021
1128
  }
1022
1129
  // Create new session file with new ID but forked content
1023
- const newSessionId = randomUUID();
1130
+ if (options?.id !== undefined) {
1131
+ assertValidSessionId(options.id);
1132
+ }
1133
+ const newSessionId = options?.id ?? createSessionId();
1024
1134
  const timestamp = new Date().toISOString();
1025
1135
  const fileTimestamp = timestamp.replace(/[:.]/g, "-");
1026
1136
  const newSessionFile = join(dir, `${fileTimestamp}_${newSessionId}.jsonl`);
@@ -1030,35 +1140,40 @@ export class SessionManager {
1030
1140
  version: CURRENT_SESSION_VERSION,
1031
1141
  id: newSessionId,
1032
1142
  timestamp,
1033
- cwd: targetCwd,
1034
- parentSession: sourcePath,
1143
+ cwd: resolvedTargetCwd,
1144
+ parentSession: resolvedSourcePath,
1035
1145
  };
1036
- appendFileSync(newSessionFile, `${JSON.stringify(newHeader)}\n`);
1146
+ writeFileSync(newSessionFile, `${JSON.stringify(newHeader)}\n`, { flag: "wx" });
1037
1147
  // Copy all non-header entries from source
1038
1148
  for (const entry of sourceEntries) {
1039
1149
  if (entry.type !== "session") {
1040
1150
  appendFileSync(newSessionFile, `${JSON.stringify(entry)}\n`);
1041
1151
  }
1042
1152
  }
1043
- return new SessionManager(targetCwd, dir, newSessionFile, true);
1153
+ return new SessionManager(resolvedTargetCwd, dir, newSessionFile, true);
1044
1154
  }
1045
1155
  /**
1046
1156
  * List all sessions for a directory.
1047
1157
  * @param cwd Working directory (used to compute default session directory)
1048
- * @param sessionDir Optional session directory. If omitted, uses default (~/.draht/agent/sessions/<encoded-cwd>/).
1158
+ * @param sessionDir Optional session directory. If omitted, uses default (~/.pi/agent/sessions/<encoded-cwd>/).
1049
1159
  * @param onProgress Optional callback for progress updates (loaded, total)
1050
1160
  */
1051
1161
  static async list(cwd, sessionDir, onProgress) {
1052
- const dir = sessionDir ?? getDefaultSessionDir(cwd);
1053
- const sessions = await listSessionsFromDir(dir, onProgress);
1162
+ const dir = sessionDir ? normalizePath(sessionDir) : getDefaultSessionDir(cwd);
1163
+ const filterCwd = sessionDir !== undefined && dir !== getDefaultSessionDirPath(cwd);
1164
+ const resolvedCwd = resolvePath(cwd);
1165
+ const sessions = (await listSessionsFromDir(dir, onProgress)).filter((session) => !filterCwd || sessionCwdMatches(session.cwd, resolvedCwd));
1054
1166
  sessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());
1055
1167
  return sessions;
1056
1168
  }
1057
- /**
1058
- * List all sessions across all project directories.
1059
- * @param onProgress Optional callback for progress updates (loaded, total)
1060
- */
1061
- static async listAll(onProgress) {
1169
+ static async listAll(sessionDirOrOnProgress, onProgress) {
1170
+ const customSessionDir = typeof sessionDirOrOnProgress === "string" ? normalizePath(sessionDirOrOnProgress) : undefined;
1171
+ const progress = typeof sessionDirOrOnProgress === "function" ? sessionDirOrOnProgress : onProgress;
1172
+ if (customSessionDir) {
1173
+ const sessions = await listSessionsFromDir(customSessionDir, progress);
1174
+ sessions.sort((a, b) => b.modified.getTime() - a.modified.getTime());
1175
+ return sessions;
1176
+ }
1062
1177
  const sessionsDir = getSessionsDir();
1063
1178
  try {
1064
1179
  if (!existsSync(sessionsDir)) {
@@ -1083,12 +1198,10 @@ export class SessionManager {
1083
1198
  let loaded = 0;
1084
1199
  const sessions = [];
1085
1200
  const allFiles = dirFiles.flat();
1086
- const results = await Promise.all(allFiles.map(async (file) => {
1087
- const info = await buildSessionInfo(file);
1201
+ const results = await buildSessionInfosWithConcurrency(allFiles, () => {
1088
1202
  loaded++;
1089
- onProgress?.(loaded, totalFiles);
1090
- return info;
1091
- }));
1203
+ progress?.(loaded, totalFiles);
1204
+ });
1092
1205
  for (const info of results) {
1093
1206
  if (info) {
1094
1207
  sessions.push(info);