@kabmo-labs/kabmo 0.27.0 → 0.29.0

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 (492) hide show
  1. package/bunfig.toml +6 -0
  2. package/dist/client/index.html +2 -2
  3. package/dist/client/index.js +530 -493
  4. package/dist/client/static/js/{index-e3qh2yps.js → index-43z47ngg.js} +1178 -1034
  5. package/dist/client/static/js/index-naa91727.css +1 -0
  6. package/dist/client/static/{manifest-q6h8k9e0.webmanifest → manifest-vdvdqpre.webmanifest} +1 -0
  7. package/marketplace/plugins/command-runner/package.json +3 -17
  8. package/marketplace/plugins/command-runner/settings-schema.json +14 -0
  9. package/marketplace/plugins/git-forge/README.md +17 -7
  10. package/marketplace/plugins/git-forge/package.json +4 -30
  11. package/marketplace/plugins/git-forge/panel.css +16 -0
  12. package/marketplace/plugins/git-forge/settings-schema.json +27 -0
  13. package/marketplace/plugins/git-forge/src/panel/Badge.tsx +35 -22
  14. package/marketplace/plugins/git-forge/src/panel/Change.tsx +20 -24
  15. package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +16 -7
  16. package/marketplace/plugins/git-forge/src/panel/Credential.tsx +31 -26
  17. package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +18 -2
  18. package/marketplace/plugins/git-forge/src/panel/Header.tsx +160 -96
  19. package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +60 -44
  20. package/marketplace/plugins/git-forge/src/panel/List.tsx +150 -22
  21. package/marketplace/plugins/git-forge/src/panel/Row.tsx +11 -5
  22. package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +17 -15
  23. package/marketplace/plugins/git-forge/src/panel/Write.tsx +84 -61
  24. package/marketplace/plugins/git-forge/src/panel/format.test.ts +99 -0
  25. package/marketplace/plugins/git-forge/src/panel/format.ts +59 -16
  26. package/marketplace/plugins/git-forge/src/panel/index.test.tsx +109 -5
  27. package/marketplace/plugins/git-forge/src/panel/index.tsx +37 -4
  28. package/marketplace/plugins/git-forge/src/panel/use-forge.ts +17 -0
  29. package/marketplace/plugins/git-forge/src/panel/write.test.tsx +31 -0
  30. package/marketplace/plugins/session-info/package.json +2 -10
  31. package/marketplace/plugins/session-info/settings-schema.json +8 -0
  32. package/marketplace/plugins/stats/README.md +17 -5
  33. package/marketplace/plugins/stats/package.json +3 -23
  34. package/marketplace/plugins/stats/settings-schema.json +20 -0
  35. package/marketplace/plugins/stats/src/app.tsx +1 -1
  36. package/marketplace/plugins/stats/src/groups.test.ts +46 -1
  37. package/marketplace/plugins/stats/src/groups.ts +22 -11
  38. package/marketplace/plugins/stats/src/harness-leases.test.ts +84 -0
  39. package/marketplace/plugins/stats/src/harness-leases.ts +132 -0
  40. package/marketplace/plugins/stats/src/labels.test.ts +54 -1
  41. package/marketplace/plugins/stats/src/labels.ts +33 -7
  42. package/marketplace/plugins/stats/src/sampler.test.ts +61 -0
  43. package/marketplace/plugins/stats/src/sampler.ts +39 -5
  44. package/marketplace/plugins/stats/src/snapshot.ts +6 -0
  45. package/package.json +4 -3
  46. package/public/manifest.webmanifest +1 -0
  47. package/src/client/components/common/ComposerTextarea.test.tsx +109 -0
  48. package/src/client/components/common/ComposerTextarea.tsx +6 -0
  49. package/src/client/components/common/ReloadPageButton.test.tsx +14 -0
  50. package/src/client/components/common/ReloadPageButton.tsx +11 -2
  51. package/src/client/components/common/diagram-viewer/read-block.test.ts +71 -0
  52. package/src/client/components/common/diagram-viewer/read-block.ts +40 -16
  53. package/src/client/components/common/file-icon/index.tsx +7 -1
  54. package/src/client/components/common/harness-glyph/brands.ts +7 -1
  55. package/src/client/components/common/harness-glyph/index.tsx +18 -1
  56. package/src/client/components/common/image-viewer/index.tsx +37 -165
  57. package/src/client/components/common/picker-search/index.tsx +70 -0
  58. package/src/client/components/common/search-select/index.tsx +2 -7
  59. package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
  60. package/src/client/components/common/session-actions-menu/index.tsx +43 -1
  61. package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
  62. package/src/client/components/common/session-row/index.tsx +4 -0
  63. package/src/client/components/common/session-row/session-row.test.tsx +6 -0
  64. package/src/client/components/common/zoom-pan-stage/index.tsx +258 -0
  65. package/src/client/components/common/zoom-pan-stage/zoom-pan-stage.test.tsx +87 -0
  66. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +2 -1
  67. package/src/client/components/layout/session-sidebar/ClassicView.tsx +1 -1
  68. package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
  69. package/src/client/components/layout/session-sidebar/SessionListNotice.tsx +7 -3
  70. package/src/client/components/layout/session-sidebar/about-modal/HarnessRow.tsx +4 -1
  71. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +12 -1
  72. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.test.tsx +82 -0
  73. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +23 -3
  74. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +1 -0
  75. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +2 -1
  76. package/src/client/components/layout/session-sidebar/modern/index.tsx +1 -1
  77. package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
  78. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
  79. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +29 -7
  80. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +3 -0
  81. package/src/client/components/layout/session-sidebar/session-list-states.test.tsx +8 -0
  82. package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +181 -0
  83. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
  84. package/src/client/components/mobile/mobile-session-sidebar/ClassicDrawer.tsx +1 -1
  85. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +2 -1
  86. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
  87. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
  88. package/src/client/components/settings/Modal.tsx +6 -2
  89. package/src/client/components/settings/Sidebar.tsx +32 -7
  90. package/src/client/components/settings/categories/HarnessSettings.tsx +15 -9
  91. package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
  92. package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
  93. package/src/client/components/settings/categories/PanelPluginSettings.tsx +3 -3
  94. package/src/client/components/settings/categories/PluginSettings.tsx +1 -1
  95. package/src/client/components/settings/categories/harness-settings/ConfigForm.tsx +3 -6
  96. package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
  97. package/src/client/components/settings/categories/panel-plugins/GitFreshness.test.tsx +36 -0
  98. package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
  99. package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
  100. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
  101. package/src/client/components/settings/categories/panel-plugins/Section.tsx +1 -3
  102. package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
  103. package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
  104. package/src/client/components/settings/categories/panel-plugins/Toolbar.tsx +18 -4
  105. package/src/client/components/settings/categories/plugin-settings/MarketplacePane.tsx +64 -61
  106. package/src/client/components/settings/categories/plugin-settings/SidebarList.tsx +15 -4
  107. package/src/client/components/settings/groups.test.tsx +2 -2
  108. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
  109. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
  110. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
  111. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +3 -2
  112. package/src/client/components/workspace/chat-timeline/IrcNotice.test.tsx +55 -0
  113. package/src/client/components/workspace/chat-timeline/IrcNotice.tsx +71 -0
  114. package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
  115. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +13 -4
  116. package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
  117. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
  118. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
  119. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
  120. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
  121. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
  122. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.test.ts +19 -0
  123. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +32 -3
  124. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.search.test.tsx +72 -0
  125. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +53 -33
  126. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
  127. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
  128. package/src/client/components/workspace/chat-timeline/index.tsx +11 -5
  129. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +1 -9
  130. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +129 -0
  131. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +30 -12
  132. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.test.tsx +47 -1
  133. package/src/client/components/workspace/chat-timeline/target-picker/WorkspacePicker.tsx +55 -5
  134. package/src/client/components/workspace/chat-timeline/tool-renderers/panels/Wait.tsx +3 -2
  135. package/src/client/components/workspace/editor/FilePane.tsx +41 -4
  136. package/src/client/components/workspace/editor/Notices.tsx +2 -2
  137. package/src/client/components/workspace/editor/Pane.tsx +2 -2
  138. package/src/client/components/workspace/editor/Toolbar.tsx +20 -10
  139. package/src/client/components/workspace/editor/index.tsx +6 -10
  140. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +5 -3
  141. package/src/client/components/workspace/editor/toolbar-clusters.tsx +26 -14
  142. package/src/client/components/workspace/editor/viewers/CsvGrid.tsx +52 -5
  143. package/src/client/components/workspace/editor/viewers/DataGrid.tsx +227 -41
  144. package/src/client/components/workspace/editor/viewers/DrawioView.tsx +93 -0
  145. package/src/client/components/workspace/editor/viewers/GridRow.tsx +91 -0
  146. package/src/client/components/workspace/editor/viewers/GridToolbar.tsx +53 -0
  147. package/src/client/components/workspace/editor/viewers/SheetView.tsx +152 -57
  148. package/src/client/components/workspace/editor/viewers/dispatch.tsx +42 -9
  149. package/src/client/components/workspace/editor/viewers/drawio-pages.test.ts +80 -0
  150. package/src/client/components/workspace/editor/viewers/drawio-pages.ts +63 -0
  151. package/src/client/components/workspace/editor/viewers/grid.test.ts +296 -0
  152. package/src/client/components/workspace/editor/viewers/use-cell-edit.ts +64 -0
  153. package/src/client/components/workspace/editor/viewers/use-grid-interaction.ts +216 -0
  154. package/src/client/components/workspace/editor/viewers/viewers.test.ts +47 -2
  155. package/src/client/components/workspace/editor/viewers/workbook.ts +149 -0
  156. package/src/client/components/workspace/file-explorer/ArchiveModals.tsx +262 -0
  157. package/src/client/components/workspace/file-explorer/ContextMenu.tsx +30 -6
  158. package/src/client/components/workspace/file-explorer/Modals.tsx +8 -3
  159. package/src/client/components/workspace/file-explorer/RootOverlays.tsx +60 -0
  160. package/src/client/components/workspace/file-explorer/RowLabel.tsx +6 -2
  161. package/src/client/components/workspace/file-explorer/TreeItem.tsx +39 -49
  162. package/src/client/components/workspace/file-explorer/TreeItemModals.tsx +80 -0
  163. package/src/client/components/workspace/file-explorer/index.tsx +53 -29
  164. package/src/client/components/workspace/file-explorer/selection.test.tsx +109 -0
  165. package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +9 -1
  166. package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
  167. package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
  168. package/src/client/components/workspace/terminal-panel/index.tsx +14 -1
  169. package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
  170. package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
  171. package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
  172. package/src/client/data/settings/omp-schema.json +169 -22
  173. package/src/client/glass.css +39 -14
  174. package/src/client/glass.test.ts +37 -0
  175. package/src/client/hooks/chat/composer/history.test.ts +267 -0
  176. package/src/client/hooks/chat/composer/history.ts +146 -0
  177. package/src/client/hooks/chat/composer/use-draft.ts +45 -1
  178. package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
  179. package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
  180. package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
  181. package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
  182. package/src/client/hooks/chat/timeline/actions.ts +4 -4
  183. package/src/client/hooks/chat/timeline/ask-frames.test.ts +54 -0
  184. package/src/client/hooks/chat/timeline/ask-frames.ts +29 -1
  185. package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
  186. package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
  187. package/src/client/hooks/chat/timeline/index.ts +5 -2
  188. package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
  189. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  190. package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
  191. package/src/client/hooks/chat/timeline/modes.ts +32 -52
  192. package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
  193. package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
  194. package/src/client/hooks/chat/timeline/pending-dispatch.ts +4 -0
  195. package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
  196. package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
  197. package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
  198. package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
  199. package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
  200. package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
  201. package/src/client/hooks/chat/timeline/send-props.ts +2 -0
  202. package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
  203. package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
  204. package/src/client/hooks/chat/timeline/send.test.ts +1 -0
  205. package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
  206. package/src/client/hooks/chat/timeline/timeline-rail.test.ts +34 -2
  207. package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
  208. package/src/client/hooks/chat/timeline/user-turns.ts +31 -2
  209. package/src/client/hooks/chat/waiting/cancel.ts +13 -6
  210. package/src/client/hooks/chat/waiting/choice.ts +13 -16
  211. package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
  212. package/src/client/hooks/chat/waiting/dispatch.ts +48 -28
  213. package/src/client/hooks/chat/waiting/held.ts +37 -13
  214. package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
  215. package/src/client/hooks/chat/waiting/hold.ts +20 -11
  216. package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
  217. package/src/client/hooks/chat/waiting/restore.ts +34 -0
  218. package/src/client/hooks/chat/waiting/store.ts +9 -3
  219. package/src/client/hooks/editor/file-editor-types.ts +36 -12
  220. package/src/client/hooks/editor/save-bytes.ts +79 -0
  221. package/src/client/hooks/editor/save-file.test.ts +1 -1
  222. package/src/client/hooks/editor/save-file.ts +35 -8
  223. package/src/client/hooks/editor/target-key.ts +17 -0
  224. package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
  225. package/src/client/hooks/editor/use-disk-digest.ts +164 -0
  226. package/src/client/hooks/editor/use-disk-sync.ts +212 -0
  227. package/src/client/hooks/editor/use-file-cache.ts +113 -0
  228. package/src/client/hooks/editor/use-file-editor.test.ts +120 -0
  229. package/src/client/hooks/editor/use-file-editor.ts +143 -57
  230. package/src/client/hooks/editor/use-file-read.ts +45 -12
  231. package/src/client/hooks/editor/use-file-writes.ts +4 -4
  232. package/src/client/hooks/editor/use-grid-selection.ts +160 -0
  233. package/src/client/hooks/models/harness-catalog.ts +15 -0
  234. package/src/client/hooks/models/use-harness-update.test.ts +35 -2
  235. package/src/client/hooks/models/use-harness-update.ts +49 -10
  236. package/src/client/hooks/ui/notifications.ts +17 -8
  237. package/src/client/hooks/workspace/diff-file.test.ts +72 -0
  238. package/src/client/hooks/workspace/diff-file.ts +12 -6
  239. package/src/client/hooks/workspace/file-archive.ts +220 -0
  240. package/src/client/hooks/workspace/file-clipboard.test.ts +4 -4
  241. package/src/client/hooks/workspace/file-clipboard.ts +37 -26
  242. package/src/client/hooks/workspace/file-selection.test.ts +67 -0
  243. package/src/client/hooks/workspace/file-selection.ts +156 -0
  244. package/src/client/hooks/workspace/file-tree-actions-clipboard.test.ts +5 -5
  245. package/src/client/hooks/workspace/file-tree-actions.ts +36 -8
  246. package/src/client/hooks/workspace/panel-registry.ts +1 -1
  247. package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
  248. package/src/client/lib/editor/workbook-drafts.ts +42 -0
  249. package/src/client/lib/launch/file-handlers.ts +2 -2
  250. package/src/client/lib/notifications/os.test.ts +1 -30
  251. package/src/client/lib/notifications/os.ts +0 -15
  252. package/src/client/lib/notifications/platform.test.ts +68 -0
  253. package/src/client/lib/notifications/platform.ts +36 -0
  254. package/src/client/lib/scrollbar-activity.test.ts +21 -88
  255. package/src/client/lib/scrollbar-activity.ts +71 -73
  256. package/src/client/lib/scrollbar-events.ts +143 -0
  257. package/src/client/lib/scrollbar-input.test.ts +126 -0
  258. package/src/client/lib/scrollbar-probe.test-util.ts +107 -0
  259. package/src/client/tailwind.css +32 -1
  260. package/src/server/db.server.test.ts +50 -1
  261. package/src/server/db.server.ts +36 -3
  262. package/src/server/index.ts +7 -0
  263. package/src/server/lib/chat/prompt-history.server.test.ts +92 -0
  264. package/src/server/lib/chat/prompt-history.server.ts +65 -0
  265. package/src/server/lib/chat/schema.server.ts +35 -0
  266. package/src/server/lib/db/schema.ts +3 -0
  267. package/src/server/lib/fs/archive.test.ts +139 -0
  268. package/src/server/lib/fs/archive.ts +259 -0
  269. package/src/server/lib/fs/git-diff.test.ts +26 -1
  270. package/src/server/lib/fs/git-diff.ts +43 -15
  271. package/src/server/lib/harness/acp/client.ts +81 -87
  272. package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
  273. package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
  274. package/src/server/lib/harness/acp/prompt.test.ts +70 -1
  275. package/src/server/lib/harness/acp/prompt.ts +32 -1
  276. package/src/server/lib/harness/acp/protocol.ts +23 -0
  277. package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
  278. package/src/server/lib/harness/acp/session-handshake.ts +22 -20
  279. package/src/server/lib/harness/acp/session-options.ts +16 -0
  280. package/src/server/lib/harness/acp/session-process.ts +43 -0
  281. package/src/server/lib/harness/acp/session.ts +11 -12
  282. package/src/server/lib/harness/acp/stdio.ts +129 -0
  283. package/src/server/lib/harness/acp/verbs.test.ts +97 -0
  284. package/src/server/lib/harness/acp/verbs.ts +16 -6
  285. package/src/server/lib/harness/auto-probe.server.ts +4 -3
  286. package/src/server/lib/harness/capabilities.ts +8 -0
  287. package/src/server/lib/harness/config.server.ts +3 -2
  288. package/src/server/lib/harness/custom.server.ts +209 -0
  289. package/src/server/lib/harness/launch-table.ts +19 -0
  290. package/src/server/lib/harness/launch.ts +6 -1
  291. package/src/server/lib/harness/provider-entry.ts +1 -1
  292. package/src/server/lib/harness/provider-file.server.ts +1 -1
  293. package/src/server/lib/harness/provider-sources.server.ts +2 -1
  294. package/src/server/lib/harness/provider-write.server.ts +2 -1
  295. package/src/server/lib/harness/register.server.ts +8 -1
  296. package/src/server/lib/harness/schema.server.ts +21 -0
  297. package/src/server/lib/harness/session-lease.server.test.ts +99 -0
  298. package/src/server/lib/harness/session-lease.server.ts +193 -0
  299. package/src/server/lib/harness/session-store.server.test.ts +8 -8
  300. package/src/server/lib/harness/session-store.server.ts +25 -4
  301. package/src/server/lib/harness/session-title.server.ts +12 -2
  302. package/src/server/lib/harness/spawn.server.ts +123 -20
  303. package/src/server/lib/harness/update-job-store.ts +12 -0
  304. package/src/server/lib/harness/update-queue.server.ts +18 -13
  305. package/src/server/lib/lifecycle/after-listen.ts +12 -1
  306. package/src/server/lib/lifecycle/paths.ts +19 -1
  307. package/src/server/lib/mcp/registry.server.ts +155 -0
  308. package/src/server/lib/mcp/registry.test.ts +169 -0
  309. package/src/server/lib/mcp/store.server.ts +38 -0
  310. package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
  311. package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
  312. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
  313. package/src/server/lib/omp/rpc/frame-fold-signals.test.ts +5 -1
  314. package/src/server/lib/omp/rpc/frame-fold.test.ts +7 -2
  315. package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
  316. package/src/server/lib/omp/rpc/lifecycle.test.ts +4 -0
  317. package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
  318. package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
  319. package/src/server/lib/omp/rpc/run-model.ts +4 -2
  320. package/src/server/lib/omp/session/auto-title.server.test.ts +4 -0
  321. package/src/server/lib/omp/session/delete.server.ts +1 -0
  322. package/src/server/lib/omp/session/goal-driver.test.ts +5 -1
  323. package/src/server/lib/omp/session/goal-settings.test.ts +5 -1
  324. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
  325. package/src/server/lib/omp/session/standby.server.ts +13 -2
  326. package/src/server/lib/panels/auto-update.server.test.ts +5 -2
  327. package/src/server/lib/panels/git-update.server.test.ts +5 -2
  328. package/src/server/lib/panels/install.server.test.ts +5 -2
  329. package/src/server/lib/panels/manifest.test.ts +47 -1
  330. package/src/server/lib/panels/manifest.ts +19 -0
  331. package/src/server/lib/panels/registry.server.ts +19 -2
  332. package/src/server/lib/panels/remove.server.test.ts +5 -2
  333. package/src/server/lib/panels/scan.server.ts +26 -2
  334. package/src/server/lib/panels/settings-schema.server.ts +72 -0
  335. package/src/server/lib/plugins/background.server.ts +21 -3
  336. package/src/server/lib/plugins/background.test.ts +13 -0
  337. package/src/server/lib/plugins/loader.server.ts +35 -51
  338. package/src/server/lib/plugins/mcp.server.ts +100 -0
  339. package/src/server/lib/plugins/mcp.test.ts +75 -0
  340. package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
  341. package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
  342. package/src/server/lib/plugins/schedule-store.server.ts +107 -0
  343. package/src/server/lib/plugins/schema.server.ts +8 -0
  344. package/src/server/lib/plugins/settings.server.ts +56 -19
  345. package/src/server/lib/plugins/shutdown.server.ts +58 -0
  346. package/src/server/lib/plugins/shutdown.test.ts +28 -3
  347. package/src/server/lib/realtime/topics/global.server.ts +5 -1
  348. package/src/server/lib/schedule/rows.server.ts +9 -0
  349. package/src/server/lib/schedule/runtime.server.test.ts +91 -0
  350. package/src/server/lib/schedule/runtime.server.ts +101 -23
  351. package/src/server/lib/schedule/schema.server.ts +15 -0
  352. package/src/server/lib/schedule/store.server.test.ts +34 -0
  353. package/src/server/lib/schedule/store.server.ts +33 -9
  354. package/src/server/lib/sessions/fork.server.test.ts +47 -0
  355. package/src/server/lib/sessions/fork.server.ts +17 -1
  356. package/src/server/lib/sessions/spawn.server.ts +2 -2
  357. package/src/server/lib/waiting/runtime.server.test.ts +48 -0
  358. package/src/server/lib/waiting/runtime.server.ts +22 -0
  359. package/src/server/lib/waiting/schema.server.ts +8 -0
  360. package/src/server/lib/waiting/store.server.test.ts +14 -0
  361. package/src/server/lib/waiting/store.server.ts +6 -2
  362. package/src/server/routes/agent/command-resume.test.ts +9 -4
  363. package/src/server/routes/agent/command.ts +11 -0
  364. package/src/server/routes/agent/new-mode.test.ts +40 -0
  365. package/src/server/routes/agent/new.ts +36 -10
  366. package/src/server/routes/agent/prewarm.ts +48 -7
  367. package/src/server/routes/chat/index.ts +5 -0
  368. package/src/server/routes/chat/prompt-history.test.ts +67 -0
  369. package/src/server/routes/chat/prompt-history.ts +31 -0
  370. package/src/server/routes/chat/stream.test.ts +21 -0
  371. package/src/server/routes/chat/stream.ts +5 -0
  372. package/src/server/routes/fs/action-archive.test.ts +128 -0
  373. package/src/server/routes/fs/action-bulk.ts +106 -0
  374. package/src/server/routes/fs/action-save-bytes.test.ts +59 -0
  375. package/src/server/routes/fs/action-transfer.test.ts +26 -0
  376. package/src/server/routes/fs/action.ts +100 -12
  377. package/src/server/routes/fs/archive.ts +20 -0
  378. package/src/server/routes/fs/digest.test.ts +100 -0
  379. package/src/server/routes/fs/digest.ts +106 -0
  380. package/src/server/routes/fs/grant.test.ts +5 -2
  381. package/src/server/routes/fs/index.ts +4 -0
  382. package/src/server/routes/fs/read.ts +6 -1
  383. package/src/server/routes/fs/scope.test.ts +6 -2
  384. package/src/server/routes/harness/custom.test.ts +131 -0
  385. package/src/server/routes/harness/import-action.ts +3 -3
  386. package/src/server/routes/harness/root.ts +47 -9
  387. package/src/server/routes/harness/summary.test.ts +50 -0
  388. package/src/server/routes/harness/update-status.ts +41 -2
  389. package/src/server/routes/harness/update.test.ts +56 -2
  390. package/src/server/routes/harness/update.ts +2 -2
  391. package/src/server/routes/panels/bindings.ts +2 -0
  392. package/src/server/routes/panels/settings.test.ts +165 -0
  393. package/src/server/routes/panels/settings.ts +106 -0
  394. package/src/server/routes/schedule/body.ts +14 -0
  395. package/src/server/routes/schedule/index.ts +28 -4
  396. package/src/server/routes/sessions/delete.test.ts +4 -0
  397. package/src/server/routes/settings/mcp.ts +9 -26
  398. package/src/server/routes/waiting/index.ts +21 -2
  399. package/src/server/routes/waiting/routes.test.ts +21 -0
  400. package/src/shared/lib/chat/ask-form/index.ts +39 -31
  401. package/src/shared/lib/chat/ask-form/labels.ts +46 -0
  402. package/src/shared/lib/chat/ask-form/tokens.ts +11 -2
  403. package/src/shared/lib/chat/ask-form.test.ts +57 -0
  404. package/src/shared/lib/chat/ask-questions.ts +31 -0
  405. package/src/shared/lib/chat/composer/delegation.ts +3 -3
  406. package/src/shared/lib/chat/composer/history.test.ts +67 -0
  407. package/src/shared/lib/chat/composer/history.ts +61 -0
  408. package/src/shared/lib/chat/irc-notice.ts +42 -0
  409. package/src/shared/lib/chat/timeline/fork-anchor.test.ts +99 -0
  410. package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
  411. package/src/shared/lib/chat/todo/parser.ts +6 -4
  412. package/src/shared/lib/fs/archive.test.ts +101 -0
  413. package/src/shared/lib/fs/archive.ts +191 -0
  414. package/src/shared/lib/fs/clipboard.test.ts +32 -7
  415. package/src/shared/lib/fs/clipboard.ts +59 -14
  416. package/src/shared/lib/fs/content-hash.ts +29 -0
  417. package/src/shared/lib/fs/csv.test.ts +50 -0
  418. package/src/shared/lib/fs/csv.ts +40 -0
  419. package/src/shared/lib/fs/document-kind.test.ts +13 -6
  420. package/src/shared/lib/fs/document-kind.ts +18 -6
  421. package/src/shared/lib/fs/file-kind-classify.test.ts +4 -0
  422. package/src/shared/lib/fs/file-kind.test.ts +2 -7
  423. package/src/shared/lib/fs/file-kind.ts +4 -2
  424. package/src/shared/lib/fs/grid-edit.test.ts +24 -0
  425. package/src/shared/lib/fs/grid-edit.ts +29 -0
  426. package/src/shared/lib/fs/grid-selection.test.ts +137 -0
  427. package/src/shared/lib/fs/grid-selection.ts +138 -0
  428. package/src/shared/lib/harness/brand-color.ts +5 -0
  429. package/src/shared/lib/harness/catalog.test.ts +22 -0
  430. package/src/shared/lib/harness/catalog.ts +60 -7
  431. package/src/shared/lib/harness/config-fields.test.ts +25 -0
  432. package/src/shared/lib/harness/config-fields.ts +33 -3
  433. package/src/shared/lib/harness/dialects.ts +1 -1
  434. package/src/shared/lib/harness/fork.ts +60 -0
  435. package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
  436. package/src/shared/lib/harness/mcp-facts.ts +69 -0
  437. package/src/shared/lib/harness/menu.test.ts +16 -1
  438. package/src/shared/lib/harness/menu.ts +2 -2
  439. package/src/shared/lib/harness/provider-contracts.ts +109 -0
  440. package/src/shared/lib/harness/provider-facts.test.ts +2 -1
  441. package/src/shared/lib/harness/provider-facts.ts +24 -115
  442. package/src/shared/lib/harness/provider-lookup.ts +37 -0
  443. package/src/shared/lib/harness/providers.ts +2 -1
  444. package/src/shared/lib/harness/rewind.ts +6 -6
  445. package/src/shared/lib/harness/session-modes.ts +31 -0
  446. package/src/shared/lib/harness/transcript.test.ts +29 -0
  447. package/src/shared/lib/harness/transcript.ts +19 -0
  448. package/src/shared/lib/harness/updates.ts +10 -0
  449. package/src/shared/lib/notifications/settings.test.ts +21 -0
  450. package/src/shared/lib/notifications/settings.ts +24 -0
  451. package/src/shared/lib/omp/session/mapper.test.ts +31 -0
  452. package/src/shared/lib/omp/session/mapper.ts +17 -0
  453. package/src/shared/lib/omp/session/messages-map-notice.test.ts +68 -0
  454. package/src/shared/lib/omp/session/messages-map.test.ts +1 -35
  455. package/src/shared/lib/omp/session/messages-map.ts +17 -0
  456. package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
  457. package/src/shared/lib/omp/session/prewarm.ts +25 -6
  458. package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
  459. package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
  460. package/src/shared/lib/omp/session/wait.ts +10 -1
  461. package/src/shared/lib/panels/capabilities.test.ts +1 -1
  462. package/src/shared/lib/panels/capabilities.ts +3 -0
  463. package/src/shared/lib/plugins/settings.ts +22 -0
  464. package/src/shared/lib/schedule/parse.test.ts +48 -0
  465. package/src/shared/lib/schedule/parse.ts +69 -45
  466. package/src/shared/lib/schedule/timezone.ts +128 -0
  467. package/src/shared/lib/settings/defaults.ts +2 -0
  468. package/src/shared/lib/settings/sections.ts +8 -4
  469. package/src/shared/lib/ui/picker-filter.test.ts +23 -0
  470. package/src/shared/lib/ui/picker-filter.ts +20 -0
  471. package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
  472. package/src/shared/lib/workspace/relative-time.ts +16 -0
  473. package/src/shared/types/chat.ts +4 -0
  474. package/src/shared/types/harness.ts +12 -1
  475. package/src/shared/types/omp/agent.ts +6 -0
  476. package/src/shared/types/omp/session.ts +18 -0
  477. package/src/shared/types/panels-registry.ts +3 -3
  478. package/src/shared/types/panels.ts +4 -2
  479. package/src/shared/types/schedule.ts +13 -0
  480. package/src/shared/types/settings/state.ts +18 -7
  481. package/src/shared/types/todo.ts +3 -1
  482. package/src/shared/types/waiting.ts +9 -0
  483. package/src/test-support/file-actions.test-util.ts +4 -0
  484. package/src/test-support/file-archive.test-util.ts +41 -0
  485. package/src/test-support/file-clipboard.test-util.ts +9 -6
  486. package/src/test-support/file-editor.test-util.ts +70 -5
  487. package/src/test-support/harness-table.test-util.ts +2 -0
  488. package/src/test-support/preload.ts +46 -0
  489. package/dist/client/static/js/index-32rpkj6b.css +0 -1
  490. package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
  491. package/src/client/hooks/editor/use-external-change.test.ts +0 -88
  492. package/src/client/hooks/editor/use-external-change.ts +0 -146
@@ -0,0 +1,46 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * A focus request the terminal could not serve yet.
8
+ *
9
+ * The panel asks for focus the moment it becomes the visible view, but the
10
+ * element that takes focus is created by `mountTerminal`, whose ghostty-web
11
+ * import resolves asynchronously. A request that lands inside that window used
12
+ * to be dropped: the keystrokes of a freshly opened panel went to whatever had
13
+ * focus before, and the user's only workaround was clicking the canvas first.
14
+ * The latch keeps the request until a terminal exists, then serves it once.
15
+ */
16
+
17
+ export interface FocusLatch {
18
+ /** Ask the current terminal for focus; remembered while there is none. */
19
+ request: () => void;
20
+ /** The terminal exists now; serve a pending request and route later ones. */
21
+ attach: (focus: () => void) => void;
22
+ /** Forget the terminal — a pending request must not revive a disposed one. */
23
+ detach: () => void;
24
+ }
25
+
26
+ export function createFocusLatch(): FocusLatch {
27
+ let target: (() => void) | null = null;
28
+ let pending = false;
29
+
30
+ return {
31
+ request() {
32
+ if (target) target();
33
+ else pending = true;
34
+ },
35
+ attach(focus) {
36
+ target = focus;
37
+ if (!pending) return;
38
+ pending = false;
39
+ focus();
40
+ },
41
+ detach() {
42
+ target = null;
43
+ pending = false;
44
+ },
45
+ };
46
+ }
@@ -1,4 +1,4 @@
1
- import { useCallback, useRef, useState } from 'preact/hooks';
1
+ import { useCallback, useEffect, useRef, useState } from 'preact/hooks';
2
2
  import { useTerminal } from '@/client/hooks/workspace/terminal';
3
3
  import { useRepoList, useRepoScope } from '@/client/hooks/workspace/repo-scope';
4
4
  import { useTheme } from '@/client/hooks/ui/theme';
@@ -53,6 +53,19 @@ export function TerminalPanel({ className = '', enabled = true, rootPath, showHe
53
53
  terminalRef.current?.write(bytes);
54
54
  }, []);
55
55
 
56
+ /**
57
+ * Opening the panel IS the intent to type, so focus follows the view becoming
58
+ * visible: a terminal that needs a click before it accepts keystrokes is a
59
+ * terminal that swallowed the first command. `active` is "selected AND the
60
+ * column is open" (see `PanelBodyProps`), so a collapsed column or another
61
+ * view on screen never points focus here, and the request survives the
62
+ * renderer's async mount (`focus.ts`).
63
+ */
64
+ useEffect(() => {
65
+ if (!active || !enabled) return;
66
+ terminalRef.current?.focus();
67
+ }, [active, enabled]);
68
+
56
69
  const handleReplay = useCallback((bytes: Uint8Array, frame: { replayCols: number; replayRows: number }) => {
57
70
  terminalRef.current?.writeReplay(bytes, frame.replayCols, frame.replayRows);
58
71
  }, []);
@@ -47,6 +47,7 @@ import {
47
47
  import { installFullWidthFit } from '@/client/components/workspace/terminal-panel/fit';
48
48
  import { createGridAnnouncer } from '@/client/components/workspace/terminal-panel/grid';
49
49
  import { attachTouchScroll, handleKeyNavigation } from '@/client/components/workspace/terminal-panel/navigation';
50
+ import { holdAcrossWrite, watchPointerPress } from '@/client/components/workspace/terminal-panel/scroll-hold';
50
51
  import {
51
52
  getTerminalTheme,
52
53
  TERMINAL_FONT_FAMILY,
@@ -111,10 +112,9 @@ export async function mountTerminal(
111
112
  ): Promise<TerminalMount | null> {
112
113
  // One dynamic import, and the WASM module is loaded once per page. Fonts are
113
114
  // fetched in parallel: the renderer measures its cell box at `open()`, and a
114
- // face that lands after that is repaired by `watchTerminalFonts`.
115
- // Dynamic on purpose: ghostty-web and its ~424 KB WASM are only needed once
116
- // the terminal panel is opened, so a static import would put them in the
117
- // initial client bundle for every page.
115
+ // face that lands after that is repaired by `watchTerminalFonts`. Dynamic on
116
+ // purpose: ghostty-web and its ~424 KB WASM are only needed once the panel is
117
+ // opened, so a static import would put them in every page's initial bundle.
118
118
  const module = await import('ghostty-web');
119
119
  const [ghostty] = await Promise.all([module.Ghostty.load(), waitForTerminalFonts()]);
120
120
  if (isCancelled()) return null;
@@ -248,13 +248,16 @@ export async function mountTerminal(
248
248
  const grid = createGridAnnouncer({
249
249
  current: () => current?.term,
250
250
  fit: safeFit,
251
- onReady: (cols, rows) => {
252
- callbacks.onReady(cols, rows);
253
- current?.term.focus();
254
- },
251
+ // Focus is NOT taken here: the panel asks for it when it becomes the
252
+ // visible view (`focus.ts`), and a terminal that grabs focus 120ms after
253
+ // the grid settles would steal it back from whatever the user clicked in
254
+ // the meantime.
255
+ onReady: callbacks.onReady,
255
256
  onGridChange: callbacks.onGridChange,
256
257
  });
257
258
 
259
+ const pointer = watchPointerPress(container);
260
+
258
261
  current = create(currentThemeId);
259
262
  safeFit();
260
263
  grid.schedule();
@@ -293,7 +296,11 @@ export async function mountTerminal(
293
296
 
294
297
  return {
295
298
  write(bytes: Uint8Array) {
296
- current?.term.write(bytes);
299
+ const term = current?.term;
300
+ if (!term) return;
301
+ // ghostty-web snaps the viewport to the bottom on every write; see
302
+ // `scroll-hold.ts` for why that made a stream impossible to select from.
303
+ holdAcrossWrite(term, pointer, () => term.write(bytes));
297
304
  },
298
305
  writeReplay,
299
306
  reset() {
@@ -333,6 +340,7 @@ export async function mountTerminal(
333
340
  grid.dispose();
334
341
  stopFontWatch();
335
342
  touch();
343
+ pointer.stop();
336
344
  resizeObserver.disconnect();
337
345
  disposeInstance(current);
338
346
  current = null;
@@ -0,0 +1,158 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The viewport a write must leave behind.
8
+ *
9
+ * ghostty-web's `writeInternal` ends with `viewportY !== 0 && scrollToBottom()`,
10
+ * so every PTY chunk re-anchors the view to the live end. Measured on the
11
+ * assembled panel before this module existed: a wheel-up during a `tail -F`
12
+ * stream was undone by the next chunk (the "Latest" button never appeared), and
13
+ * a two-row drag during a 100 lines/s stream copied twelve lines because the
14
+ * content moved between the press and the release.
15
+ */
16
+
17
+ import { describe, expect, test } from 'bun:test';
18
+ import {
19
+ heldTop,
20
+ holdAcrossWrite,
21
+ viewportYForTop,
22
+ watchPointerPress,
23
+ type HoldableViewport,
24
+ } from '@/client/components/workspace/terminal-panel/scroll-hold';
25
+
26
+ /** A viewport whose scrollback grows by `appended` lines on every write. */
27
+ function fakeViewport(options: { scrollback: number; viewportY: number; appended: number; hasSelection?: boolean }) {
28
+ const state = {
29
+ scrollback: options.scrollback,
30
+ viewportY: options.viewportY,
31
+ hasSelection: options.hasSelection ?? false,
32
+ scrollCalls: [] as number[],
33
+ };
34
+ const viewport: HoldableViewport = {
35
+ getScrollbackLength: () => state.scrollback,
36
+ getViewportY: () => state.viewportY,
37
+ hasSelection: () => state.hasSelection,
38
+ scrollLines: (amount) => {
39
+ state.scrollCalls.push(amount);
40
+ state.viewportY = Math.max(0, Math.min(state.scrollback, state.viewportY - amount));
41
+ },
42
+ };
43
+ const write = () => {
44
+ state.scrollback += options.appended;
45
+ // The library's own snap, which the hold has to undo.
46
+ state.viewportY = 0;
47
+ };
48
+ return { viewport, state, write };
49
+ }
50
+
51
+ describe('heldTop', () => {
52
+ test('follows output when the reader is at the bottom with nothing selected', () => {
53
+ expect(heldTop({ scrollback: 500, viewportY: 0, hasSelection: false, pointerHeld: false })).toBeNull();
54
+ });
55
+
56
+ test('holds the absolute row the reader scrolled to', () => {
57
+ expect(heldTop({ scrollback: 500, viewportY: 120, hasSelection: false, pointerHeld: false })).toBe(380);
58
+ });
59
+
60
+ test('holds while a selection exists, even at the bottom', () => {
61
+ expect(heldTop({ scrollback: 500, viewportY: 0, hasSelection: true, pointerHeld: false })).toBe(500);
62
+ });
63
+
64
+ test('holds from the press, before the engine has a selection', () => {
65
+ expect(heldTop({ scrollback: 500, viewportY: 0, hasSelection: false, pointerHeld: true })).toBe(500);
66
+ });
67
+ });
68
+
69
+ describe('viewportYForTop', () => {
70
+ test('turns the held row back into a distance from the bottom', () => {
71
+ expect(viewportYForTop({ scrollback: 620, top: 380 })).toBe(240);
72
+ });
73
+
74
+ test('reports the bottom as null, so no scroll is issued', () => {
75
+ expect(viewportYForTop({ scrollback: 500, top: 500 })).toBeNull();
76
+ });
77
+ });
78
+
79
+ describe('holdAcrossWrite', () => {
80
+ test('keeps the same content on screen as a stream appends lines', () => {
81
+ const { viewport, state, write } = fakeViewport({ scrollback: 500, viewportY: 120, appended: 3 });
82
+ holdAcrossWrite(viewport, { pointerHeld: false }, write);
83
+ // The top row (380) is still the top row: 503 - 380 = 123, and the snap to
84
+ // zero is undone in one scroll call.
85
+ expect(state.viewportY).toBe(123);
86
+ expect(state.scrollCalls).toEqual([-123]);
87
+ });
88
+
89
+ test('lets ordinary output scroll when nothing holds the view', () => {
90
+ const { viewport, state, write } = fakeViewport({ scrollback: 500, viewportY: 0, appended: 3 });
91
+ holdAcrossWrite(viewport, { pointerHeld: false }, write);
92
+ expect(state.viewportY).toBe(0);
93
+ expect(state.scrollCalls).toEqual([]);
94
+ });
95
+
96
+ test('holds a selection at the bottom, so a copy is not scrolled away', () => {
97
+ const { viewport, state, write } = fakeViewport({ scrollback: 500, viewportY: 0, appended: 2, hasSelection: true });
98
+ holdAcrossWrite(viewport, { pointerHeld: false }, write);
99
+ expect(state.viewportY).toBe(2);
100
+ });
101
+
102
+ test('holds from the press, before the drag threshold is met', () => {
103
+ const { viewport, state, write } = fakeViewport({ scrollback: 500, viewportY: 0, appended: 4 });
104
+ holdAcrossWrite(viewport, { pointerHeld: true }, write);
105
+ expect(state.viewportY).toBe(4);
106
+ });
107
+
108
+ test('a released press with no selection follows output again', () => {
109
+ const { viewport, state, write } = fakeViewport({ scrollback: 500, viewportY: 0, appended: 4 });
110
+ holdAcrossWrite(viewport, { pointerHeld: false }, write);
111
+ expect(state.viewportY).toBe(0);
112
+ });
113
+
114
+ test('a disposed terminal does not throw out of the write path', () => {
115
+ const viewport: HoldableViewport = {
116
+ getScrollbackLength: () => 500,
117
+ getViewportY: () => 120,
118
+ hasSelection: () => false,
119
+ scrollLines: () => {
120
+ throw new Error('Terminal not open');
121
+ },
122
+ };
123
+ expect(() => holdAcrossWrite(viewport, { pointerHeld: false }, () => {})).not.toThrow();
124
+ });
125
+ });
126
+
127
+ describe('watchPointerPress', () => {
128
+ /** A container that is an event target but not a DOM element — all the watcher touches. */
129
+ const container = () => new EventTarget() as unknown as HTMLElement;
130
+
131
+ test('holds from the press and lets go on release', () => {
132
+ const element = container();
133
+ const watch = watchPointerPress(element);
134
+ expect(watch.pointerHeld).toBe(false);
135
+ element.dispatchEvent(new Event('pointerdown'));
136
+ expect(watch.pointerHeld).toBe(true);
137
+ globalThis.dispatchEvent(new Event('pointerup'));
138
+ expect(watch.pointerHeld).toBe(false);
139
+ watch.stop();
140
+ });
141
+
142
+ test('a cancelled gesture ends the hold, not a stuck viewport', () => {
143
+ const element = container();
144
+ const watch = watchPointerPress(element);
145
+ element.dispatchEvent(new Event('pointerdown'));
146
+ globalThis.dispatchEvent(new Event('pointercancel'));
147
+ expect(watch.pointerHeld).toBe(false);
148
+ watch.stop();
149
+ });
150
+
151
+ test('stop() detaches, so a disposed mount cannot hold a later one', () => {
152
+ const element = container();
153
+ const watch = watchPointerPress(element);
154
+ watch.stop();
155
+ element.dispatchEvent(new Event('pointerdown'));
156
+ expect(watch.pointerHeld).toBe(false);
157
+ });
158
+ });
@@ -0,0 +1,136 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What a write must do to the viewport it inherited.
8
+ *
9
+ * ghostty-web's `writeInternal` ends with `viewportY !== 0 && scrollToBottom()`,
10
+ * so EVERY chunk of PTY output re-anchors the view to the live end. A stream
11
+ * (`tail -F`, a build log, `yes`) therefore cannot be read or selected at all:
12
+ * a wheel-up was undone by the next chunk, and a drag that started on a line
13
+ * ended on whatever had scrolled under the pointer by the release — measured on
14
+ * the assembled panel, a two-row drag during a 100 lines/s stream copied twelve
15
+ * lines.
16
+ *
17
+ * Three states hold the view, each for its own measured failure:
18
+ *
19
+ * - **Scrolled back** (`viewportY > 0`): nothing above the live line could be
20
+ * read while output kept arriving.
21
+ * - **Pointer down**: a copy starts with a press, and the engine's own
22
+ * selection does not exist until the drag passes its 0.5-cell threshold, so
23
+ * the rows move out from under the gesture before there is anything to hold.
24
+ * - **Selection exists**: a selection outlives the drag (drag, release, read,
25
+ * press ⌘C), and output arriving in that window used to scroll it away
26
+ * before the copy ran.
27
+ *
28
+ * Everything else follows the live output, which is what a terminal does.
29
+ *
30
+ * The hold is stated as an ABSOLUTE buffer row, not as a distance from the
31
+ * bottom: as lines are appended the same content must stay on screen, so the
32
+ * distance from the bottom has to grow with the scrollback. `heldTop` captures
33
+ * that row before a write and `viewportYForTop` turns it back into a
34
+ * `viewportY` after it. The write is synchronous, so the restore lands before
35
+ * the next paint — the library's own snap is never shown.
36
+ */
37
+
38
+ /** The absolute buffer row at the top of the viewport, or null when the view follows output. */
39
+ export function heldTop(input: {
40
+ scrollback: number;
41
+ viewportY: number;
42
+ hasSelection: boolean;
43
+ pointerHeld: boolean;
44
+ }): number | null {
45
+ if (input.viewportY <= 0 && !input.hasSelection && !input.pointerHeld) return null;
46
+ return input.scrollback - input.viewportY;
47
+ }
48
+
49
+ /** The `viewportY` that puts `top` back at the top of the viewport, or null at the bottom. */
50
+ export function viewportYForTop(input: { scrollback: number; top: number }): number | null {
51
+ const viewportY = input.scrollback - input.top;
52
+ return viewportY > 0 ? viewportY : null;
53
+ }
54
+
55
+ /**
56
+ * The viewport methods the hold reads and drives.
57
+ *
58
+ * Narrow on purpose: `scrollLines` is how the library's own scroll path is
59
+ * driven — it clamps, fires `onScroll` (which is what keeps the "Latest" button
60
+ * honest) and repaints — while assigning `viewportY` directly skips all three.
61
+ */
62
+ export interface HoldableViewport {
63
+ getScrollbackLength: () => number;
64
+ getViewportY: () => number;
65
+ hasSelection: () => boolean;
66
+ scrollLines: (amount: number) => void;
67
+ }
68
+
69
+ /**
70
+ * Watch the press that starts a selection.
71
+ *
72
+ * `pointerdown` in the CAPTURE phase on the container: ghostty-web's selection
73
+ * manager attaches its own mousedown and stops propagation once its scrollbar
74
+ * wins, and the hold has to start at the press — before the engine's own
75
+ * selection exists, because its drag threshold (half a cell) leaves a window in
76
+ * which a stream has already moved the rows out from under the gesture.
77
+ *
78
+ * Release is watched on the WINDOW: a drag that ends outside the panel (over the
79
+ * sidebar, or off the app) must end the hold too, or output stops following
80
+ * forever.
81
+ *
82
+ * Returns the state the write path reads, plus its own teardown.
83
+ */
84
+ export function watchPointerPress(container: HTMLElement): { pointerHeld: boolean; stop: () => void } {
85
+ const state = { pointerHeld: false };
86
+ const press = (): void => {
87
+ state.pointerHeld = true;
88
+ };
89
+ const release = (): void => {
90
+ state.pointerHeld = false;
91
+ };
92
+ container.addEventListener('pointerdown', press, true);
93
+ globalThis.addEventListener('pointerup', release);
94
+ globalThis.addEventListener('pointercancel', release);
95
+ return {
96
+ get pointerHeld() {
97
+ return state.pointerHeld;
98
+ },
99
+ stop() {
100
+ container.removeEventListener('pointerdown', press, true);
101
+ globalThis.removeEventListener('pointerup', release);
102
+ globalThis.removeEventListener('pointercancel', release);
103
+ },
104
+ };
105
+ }
106
+
107
+ /**
108
+ * Run `write`, then put the viewport back where the reader left it.
109
+ *
110
+ * A no-op when nothing holds the view, so ordinary output still scrolls the way
111
+ * a terminal should.
112
+ */
113
+ export function holdAcrossWrite(
114
+ viewport: HoldableViewport,
115
+ state: { pointerHeld: boolean },
116
+ write: () => void,
117
+ ): void {
118
+ const top = heldTop({
119
+ scrollback: viewport.getScrollbackLength(),
120
+ viewportY: viewport.getViewportY(),
121
+ hasSelection: viewport.hasSelection(),
122
+ pointerHeld: state.pointerHeld,
123
+ });
124
+ write();
125
+ if (top === null) return;
126
+ const target = viewportYForTop({ scrollback: viewport.getScrollbackLength(), top });
127
+ if (target === null) return;
128
+ const delta = target - viewport.getViewportY();
129
+ if (delta === 0) return;
130
+ try {
131
+ // Positive `amount` scrolls toward the top, so a positive delta moves back.
132
+ viewport.scrollLines(-delta);
133
+ } catch {
134
+ // A disposed terminal has no wasm buffer; the next mount starts at the bottom.
135
+ }
136
+ }