@draht/coding-agent 2026.5.12 → 2026.7.7

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