@kabmo-labs/kabmo 0.26.0 → 0.28.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 (354) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +502 -474
  3. package/dist/client/static/js/index-81f7berm.css +1 -0
  4. package/dist/client/static/js/{index-95b3n20k.js → index-xzvyrxya.js} +799 -799
  5. package/marketplace/plugins/command-runner/package.json +3 -17
  6. package/marketplace/plugins/command-runner/settings-schema.json +14 -0
  7. package/marketplace/plugins/git-forge/README.md +17 -7
  8. package/marketplace/plugins/git-forge/package.json +4 -30
  9. package/marketplace/plugins/git-forge/panel.css +16 -0
  10. package/marketplace/plugins/git-forge/settings-schema.json +27 -0
  11. package/marketplace/plugins/git-forge/src/panel/Badge.tsx +35 -22
  12. package/marketplace/plugins/git-forge/src/panel/Change.tsx +20 -24
  13. package/marketplace/plugins/git-forge/src/panel/CiBadge.tsx +16 -7
  14. package/marketplace/plugins/git-forge/src/panel/Credential.tsx +31 -26
  15. package/marketplace/plugins/git-forge/src/panel/Glyph.tsx +18 -2
  16. package/marketplace/plugins/git-forge/src/panel/Header.tsx +160 -96
  17. package/marketplace/plugins/git-forge/src/panel/ItemView.tsx +60 -44
  18. package/marketplace/plugins/git-forge/src/panel/List.tsx +150 -22
  19. package/marketplace/plugins/git-forge/src/panel/Row.tsx +11 -5
  20. package/marketplace/plugins/git-forge/src/panel/Sidebar.tsx +17 -15
  21. package/marketplace/plugins/git-forge/src/panel/Write.tsx +84 -61
  22. package/marketplace/plugins/git-forge/src/panel/format.test.ts +99 -0
  23. package/marketplace/plugins/git-forge/src/panel/format.ts +59 -16
  24. package/marketplace/plugins/git-forge/src/panel/index.test.tsx +109 -5
  25. package/marketplace/plugins/git-forge/src/panel/index.tsx +37 -4
  26. package/marketplace/plugins/git-forge/src/panel/use-forge.ts +17 -0
  27. package/marketplace/plugins/git-forge/src/panel/write.test.tsx +31 -0
  28. package/marketplace/plugins/session-info/package.json +2 -10
  29. package/marketplace/plugins/session-info/settings-schema.json +8 -0
  30. package/marketplace/plugins/stats/README.md +17 -5
  31. package/marketplace/plugins/stats/package.json +3 -23
  32. package/marketplace/plugins/stats/settings-schema.json +20 -0
  33. package/marketplace/plugins/stats/src/app.tsx +1 -1
  34. package/marketplace/plugins/stats/src/groups.test.ts +46 -1
  35. package/marketplace/plugins/stats/src/groups.ts +22 -11
  36. package/marketplace/plugins/stats/src/harness-leases.test.ts +84 -0
  37. package/marketplace/plugins/stats/src/harness-leases.ts +132 -0
  38. package/marketplace/plugins/stats/src/labels.test.ts +54 -1
  39. package/marketplace/plugins/stats/src/labels.ts +33 -7
  40. package/marketplace/plugins/stats/src/sampler.test.ts +61 -0
  41. package/marketplace/plugins/stats/src/sampler.ts +39 -5
  42. package/marketplace/plugins/stats/src/snapshot.ts +6 -0
  43. package/package.json +2 -2
  44. package/src/client/components/common/Toast.test.tsx +28 -2
  45. package/src/client/components/common/Toast.tsx +21 -9
  46. package/src/client/components/common/harness-glyph/index.tsx +18 -1
  47. package/src/client/components/common/session-actions-menu/index.test.tsx +106 -0
  48. package/src/client/components/common/session-actions-menu/index.tsx +43 -1
  49. package/src/client/components/common/session-row/TrailingSlot.tsx +9 -4
  50. package/src/client/components/common/session-row/index.tsx +4 -0
  51. package/src/client/components/common/session-row/session-row.test.tsx +6 -0
  52. package/src/client/components/layout/desktop-layout/LeftColumn.tsx +2 -1
  53. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +4 -2
  54. package/src/client/components/layout/session-sidebar/SessionItem.tsx +9 -1
  55. package/src/client/components/layout/session-sidebar/SessionList.tsx +2 -1
  56. package/src/client/components/layout/session-sidebar/about-modal/UpdateSection.tsx +3 -2
  57. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +2 -1
  58. package/src/client/components/layout/session-sidebar/modern/RevealRow.tsx +56 -0
  59. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +12 -29
  60. package/src/client/components/layout/session-sidebar/modern/reveal-row.test.tsx +104 -0
  61. package/src/client/components/layout/session-sidebar/scheduler-modal/ModelFields.tsx +202 -0
  62. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskForm.tsx +80 -19
  63. package/src/client/components/layout/session-sidebar/scheduler-modal/TaskList.tsx +23 -3
  64. package/src/client/components/layout/session-sidebar/scheduler-modal/index.tsx +5 -1
  65. package/src/client/components/layout/session-sidebar/variant-props.ts +2 -1
  66. package/src/client/components/mobile/SessionSidebar.tsx +2 -1
  67. package/src/client/components/mobile/mobile-right-sidebar/EditorSurface.tsx +156 -0
  68. package/src/client/components/mobile/mobile-right-sidebar/FullEditor.tsx +41 -86
  69. package/src/client/components/mobile/mobile-session-sidebar/ClassicDrawer.tsx +2 -1
  70. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +4 -2
  71. package/src/client/components/mobile/mobile-session-sidebar/List.tsx +2 -1
  72. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +6 -0
  73. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +9 -1
  74. package/src/client/components/settings/Modal.tsx +7 -3
  75. package/src/client/components/settings/Sidebar.tsx +30 -3
  76. package/src/client/components/settings/categories/HarnessSettings.tsx +11 -7
  77. package/src/client/components/settings/categories/NotificationSettings.test.tsx +40 -15
  78. package/src/client/components/settings/categories/NotificationSettings.tsx +142 -64
  79. package/src/client/components/settings/categories/PanelPluginSettings.tsx +1 -1
  80. package/src/client/components/settings/categories/harness-settings/CustomHarnessForm.tsx +186 -0
  81. package/src/client/components/settings/categories/panel-plugins/InstalledList.tsx +11 -0
  82. package/src/client/components/settings/categories/panel-plugins/PluginCard.test.tsx +1 -0
  83. package/src/client/components/settings/categories/panel-plugins/PluginCard.tsx +15 -1
  84. package/src/client/components/settings/categories/panel-plugins/SettingsModal.test.tsx +165 -0
  85. package/src/client/components/settings/categories/panel-plugins/SettingsModal.tsx +260 -0
  86. package/src/client/components/settings/categories/project-settings/WorktreeSettings.tsx +2 -1
  87. package/src/client/components/settings/categories/usage-settings/LimitsSection.tsx +39 -19
  88. package/src/client/components/settings/categories/usage-settings/ProviderDetail.tsx +1 -0
  89. package/src/client/components/settings/categories/usage-settings/limit-groups.test.ts +94 -0
  90. package/src/client/components/settings/categories/usage-settings/limit-groups.ts +118 -0
  91. package/src/client/components/settings/categories/usage-settings/limits-section.test.tsx +118 -0
  92. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +24 -0
  93. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +8 -4
  94. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +34 -0
  95. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +61 -56
  96. package/src/client/components/workspace/chat-timeline/MessageItem.fork.test.ts +80 -0
  97. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +9 -3
  98. package/src/client/components/workspace/chat-timeline/MessageList.tsx +3 -1
  99. package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +11 -1
  100. package/src/client/components/workspace/chat-timeline/PendingTranscript.tsx +130 -0
  101. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +2 -1
  102. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +2 -1
  103. package/src/client/components/workspace/chat-timeline/chat-input/ComposerRows.tsx +8 -0
  104. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +9 -0
  105. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +4 -1
  106. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +24 -0
  107. package/src/client/components/workspace/chat-timeline/chat-input/WaitingDependencyPicker.tsx +13 -20
  108. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +2 -0
  109. package/src/client/components/workspace/chat-timeline/chat-input/props.ts +5 -5
  110. package/src/client/components/workspace/chat-timeline/fork-preview.test.tsx +141 -0
  111. package/src/client/components/workspace/chat-timeline/index.tsx +17 -6
  112. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +3 -10
  113. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.test.tsx +101 -0
  114. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +2 -2
  115. package/src/client/components/workspace/chat-timeline/target-picker/WorktreePicker.tsx +5 -4
  116. package/src/client/components/workspace/editor/FilePane.tsx +9 -4
  117. package/src/client/components/workspace/editor/Notices.tsx +2 -2
  118. package/src/client/components/workspace/editor/Pane.tsx +2 -2
  119. package/src/client/components/workspace/editor/Toolbar.tsx +16 -10
  120. package/src/client/components/workspace/editor/index.tsx +6 -10
  121. package/src/client/components/workspace/editor/toolbar-clusters.test.ts +4 -3
  122. package/src/client/components/workspace/editor/toolbar-clusters.tsx +23 -14
  123. package/src/client/components/workspace/git-panel/index.tsx +2 -2
  124. package/src/client/components/workspace/terminal-panel/RealtimeTerminalView.tsx +17 -6
  125. package/src/client/components/workspace/terminal-panel/focus.test.ts +70 -0
  126. package/src/client/components/workspace/terminal-panel/focus.ts +46 -0
  127. package/src/client/components/workspace/terminal-panel/index.tsx +17 -1
  128. package/src/client/components/workspace/terminal-panel/mount.ts +17 -9
  129. package/src/client/components/workspace/terminal-panel/scroll-hold.test.ts +158 -0
  130. package/src/client/components/workspace/terminal-panel/scroll-hold.ts +136 -0
  131. package/src/client/hooks/chat/composer/use-draft.ts +45 -1
  132. package/src/client/hooks/chat/omp/pending-sessions.waiting.test.ts +11 -10
  133. package/src/client/hooks/chat/omp/pending-waiting.ts +15 -7
  134. package/src/client/hooks/chat/omp/prompt-send.test.ts +11 -0
  135. package/src/client/hooks/chat/omp/prompt-send.ts +3 -0
  136. package/src/client/hooks/chat/omp/session-list.tsx +5 -0
  137. package/src/client/hooks/chat/omp/sidebar-reload.test.ts +85 -0
  138. package/src/client/hooks/chat/omp/sidebar-reload.ts +30 -0
  139. package/src/client/hooks/chat/timeline/actions.ts +4 -4
  140. package/src/client/hooks/chat/timeline/composer-modes.ts +13 -2
  141. package/src/client/hooks/chat/timeline/fork-open.ts +52 -0
  142. package/src/client/hooks/chat/timeline/fork-preview.test.ts +148 -0
  143. package/src/client/hooks/chat/timeline/fork-preview.ts +104 -0
  144. package/src/client/hooks/chat/timeline/fork-send.test.ts +139 -0
  145. package/src/client/hooks/chat/timeline/index.ts +5 -2
  146. package/src/client/hooks/chat/timeline/mode-availability.ts +7 -0
  147. package/src/client/hooks/chat/timeline/modes-contract.ts +6 -0
  148. package/src/client/hooks/chat/timeline/modes-hydrate.ts +93 -0
  149. package/src/client/hooks/chat/timeline/modes.ts +32 -52
  150. package/src/client/hooks/chat/timeline/new-chat-open.ts +7 -6
  151. package/src/client/hooks/chat/timeline/new-chat.ts +10 -1
  152. package/src/client/hooks/chat/timeline/pending-branch.ts +9 -0
  153. package/src/client/hooks/chat/timeline/pending-dispatch.ts +53 -0
  154. package/src/client/hooks/chat/timeline/pending-session-mode.test.ts +136 -0
  155. package/src/client/hooks/chat/timeline/pending-session-mode.ts +69 -0
  156. package/src/client/hooks/chat/timeline/pending-warmup.test.ts +147 -0
  157. package/src/client/hooks/chat/timeline/pending-warmup.ts +62 -0
  158. package/src/client/hooks/chat/timeline/run-identity.test.ts +12 -0
  159. package/src/client/hooks/chat/timeline/run-identity.ts +4 -1
  160. package/src/client/hooks/chat/timeline/send-props.ts +2 -0
  161. package/src/client/hooks/chat/timeline/send-steer.test.ts +1 -0
  162. package/src/client/hooks/chat/timeline/send.test-util.ts +1 -0
  163. package/src/client/hooks/chat/timeline/send.test.ts +1 -0
  164. package/src/client/hooks/chat/timeline/session-harness.ts +4 -0
  165. package/src/client/hooks/chat/timeline/stop-with-queue.ts +1 -1
  166. package/src/client/hooks/chat/timeline/use-fork-session.ts +9 -22
  167. package/src/client/hooks/chat/waiting/cancel.ts +15 -7
  168. package/src/client/hooks/chat/waiting/choice.ts +13 -16
  169. package/src/client/hooks/chat/waiting/composer-wait.ts +70 -0
  170. package/src/client/hooks/chat/waiting/dispatch.ts +50 -29
  171. package/src/client/hooks/chat/waiting/held.ts +38 -13
  172. package/src/client/hooks/chat/waiting/hold.test.ts +22 -0
  173. package/src/client/hooks/chat/waiting/hold.ts +20 -11
  174. package/src/client/hooks/chat/waiting/restore.test.ts +69 -0
  175. package/src/client/hooks/chat/waiting/restore.ts +34 -0
  176. package/src/client/hooks/chat/waiting/store.ts +9 -3
  177. package/src/client/hooks/editor/file-editor-types.ts +21 -12
  178. package/src/client/hooks/editor/save-file.test.ts +1 -1
  179. package/src/client/hooks/editor/save-file.ts +35 -8
  180. package/src/client/hooks/editor/target-key.ts +17 -0
  181. package/src/client/hooks/editor/use-disk-digest.test.ts +82 -0
  182. package/src/client/hooks/editor/use-disk-digest.ts +164 -0
  183. package/src/client/hooks/editor/use-disk-sync.ts +212 -0
  184. package/src/client/hooks/editor/use-file-cache.ts +113 -0
  185. package/src/client/hooks/editor/use-file-editor.test.ts +90 -0
  186. package/src/client/hooks/editor/use-file-editor.ts +90 -52
  187. package/src/client/hooks/editor/use-file-read.ts +24 -10
  188. package/src/client/hooks/editor/use-file-writes.ts +4 -4
  189. package/src/client/hooks/models/harness-catalog.ts +15 -0
  190. package/src/client/hooks/settings/providers/actions.ts +3 -2
  191. package/src/client/hooks/settings/providers/messages.ts +9 -7
  192. package/src/client/hooks/settings/providers/model-actions.ts +2 -1
  193. package/src/client/hooks/ui/editor-error-toast.ts +2 -1
  194. package/src/client/hooks/ui/notifications.ts +17 -8
  195. package/src/client/hooks/workspace/batch-archive.test.ts +2 -2
  196. package/src/client/hooks/workspace/batch-archive.ts +4 -2
  197. package/src/client/hooks/workspace/git-action-outcome.ts +4 -3
  198. package/src/client/hooks/workspace/navbar-session-actions.ts +2 -1
  199. package/src/client/hooks/workspace/panel-registry.ts +1 -1
  200. package/src/client/hooks/workspace/scheduled-tasks.ts +26 -11
  201. package/src/client/hooks/workspace/session-actions.test.ts +2 -1
  202. package/src/client/hooks/workspace/session-actions.ts +2 -1
  203. package/src/client/hooks/workspace/terminal/connection.test.ts +63 -0
  204. package/src/client/hooks/workspace/terminal/connection.ts +47 -0
  205. package/src/client/hooks/workspace/terminal/index.ts +35 -4
  206. package/src/client/hooks/workspace/workspace-folder-actions.ts +2 -1
  207. package/src/client/lib/notifications/os.test.ts +1 -30
  208. package/src/client/lib/notifications/os.ts +0 -15
  209. package/src/client/lib/notifications/platform.test.ts +68 -0
  210. package/src/client/lib/notifications/platform.ts +36 -0
  211. package/src/server/index.ts +7 -0
  212. package/src/server/lib/harness/acp/client.ts +81 -87
  213. package/src/server/lib/harness/acp/prewarm.server.ts +237 -0
  214. package/src/server/lib/harness/acp/prewarm.test.ts +171 -0
  215. package/src/server/lib/harness/acp/prompt.test.ts +70 -1
  216. package/src/server/lib/harness/acp/prompt.ts +32 -1
  217. package/src/server/lib/harness/acp/protocol.ts +23 -0
  218. package/src/server/lib/harness/acp/session-handshake.test.ts +26 -0
  219. package/src/server/lib/harness/acp/session-handshake.ts +22 -20
  220. package/src/server/lib/harness/acp/session-options.ts +16 -0
  221. package/src/server/lib/harness/acp/session-process.ts +43 -0
  222. package/src/server/lib/harness/acp/session.ts +11 -12
  223. package/src/server/lib/harness/acp/stdio.ts +129 -0
  224. package/src/server/lib/harness/acp/verbs.test.ts +97 -0
  225. package/src/server/lib/harness/acp/verbs.ts +16 -6
  226. package/src/server/lib/harness/auto-probe.server.ts +4 -3
  227. package/src/server/lib/harness/capabilities.ts +8 -0
  228. package/src/server/lib/harness/config.server.ts +3 -2
  229. package/src/server/lib/harness/custom.server.ts +209 -0
  230. package/src/server/lib/harness/launch.ts +6 -1
  231. package/src/server/lib/harness/register.server.ts +8 -1
  232. package/src/server/lib/harness/schema.server.ts +21 -0
  233. package/src/server/lib/harness/session-lease.server.test.ts +99 -0
  234. package/src/server/lib/harness/session-lease.server.ts +193 -0
  235. package/src/server/lib/harness/session-store.server.test.ts +8 -8
  236. package/src/server/lib/harness/session-store.server.ts +25 -4
  237. package/src/server/lib/harness/session-title.server.ts +12 -2
  238. package/src/server/lib/harness/spawn.server.ts +123 -20
  239. package/src/server/lib/harness/update-queue.server.ts +3 -3
  240. package/src/server/lib/lifecycle/after-listen.ts +12 -1
  241. package/src/server/lib/lifecycle/paths.ts +19 -1
  242. package/src/server/lib/mcp/registry.server.ts +155 -0
  243. package/src/server/lib/mcp/registry.test.ts +169 -0
  244. package/src/server/lib/mcp/store.server.ts +38 -0
  245. package/src/server/lib/omp/rpc/frame-fold-contract.ts +59 -0
  246. package/src/server/lib/omp/rpc/frame-fold-frames.test.ts +64 -1
  247. package/src/server/lib/omp/rpc/frame-fold-host.test-util.ts +2 -1
  248. package/src/server/lib/omp/rpc/frame-fold.test.ts +2 -1
  249. package/src/server/lib/omp/rpc/frame-fold.ts +6 -45
  250. package/src/server/lib/omp/rpc/prewarm-pool.ts +19 -5
  251. package/src/server/lib/omp/rpc/run-model.test.ts +116 -0
  252. package/src/server/lib/omp/rpc/run-model.ts +4 -2
  253. package/src/server/lib/omp/session/sidebar-data.harness.test.ts +6 -3
  254. package/src/server/lib/omp/session/standby.server.ts +13 -2
  255. package/src/server/lib/panels/manifest.test.ts +47 -1
  256. package/src/server/lib/panels/manifest.ts +19 -0
  257. package/src/server/lib/panels/registry.server.ts +19 -2
  258. package/src/server/lib/panels/scan.server.ts +26 -2
  259. package/src/server/lib/panels/settings-schema.server.ts +72 -0
  260. package/src/server/lib/plugins/background.server.ts +21 -3
  261. package/src/server/lib/plugins/background.test.ts +13 -0
  262. package/src/server/lib/plugins/loader.server.ts +35 -51
  263. package/src/server/lib/plugins/mcp.server.ts +100 -0
  264. package/src/server/lib/plugins/mcp.test.ts +75 -0
  265. package/src/server/lib/plugins/schedule-runner.server.ts +153 -0
  266. package/src/server/lib/plugins/schedule-runner.test.ts +186 -0
  267. package/src/server/lib/plugins/schedule-store.server.ts +107 -0
  268. package/src/server/lib/plugins/schema.server.ts +8 -0
  269. package/src/server/lib/plugins/settings.server.ts +56 -19
  270. package/src/server/lib/plugins/shutdown.server.ts +58 -0
  271. package/src/server/lib/plugins/shutdown.test.ts +28 -3
  272. package/src/server/lib/realtime/topics/global.server.ts +5 -1
  273. package/src/server/lib/schedule/rows.server.ts +9 -0
  274. package/src/server/lib/schedule/runtime.server.test.ts +91 -0
  275. package/src/server/lib/schedule/runtime.server.ts +101 -23
  276. package/src/server/lib/schedule/schema.server.ts +15 -0
  277. package/src/server/lib/schedule/store.server.test.ts +34 -0
  278. package/src/server/lib/schedule/store.server.ts +33 -9
  279. package/src/server/lib/sessions/fork.server.test.ts +47 -0
  280. package/src/server/lib/sessions/fork.server.ts +17 -1
  281. package/src/server/lib/sessions/spawn.server.ts +2 -2
  282. package/src/server/lib/usage/report.server.ts +57 -0
  283. package/src/server/lib/waiting/runtime.server.test.ts +48 -0
  284. package/src/server/lib/waiting/runtime.server.ts +22 -0
  285. package/src/server/lib/waiting/schema.server.ts +8 -0
  286. package/src/server/lib/waiting/store.server.test.ts +14 -0
  287. package/src/server/lib/waiting/store.server.ts +6 -2
  288. package/src/server/routes/agent/command-resume.test.ts +9 -4
  289. package/src/server/routes/agent/new-mode.test.ts +40 -0
  290. package/src/server/routes/agent/new.ts +31 -10
  291. package/src/server/routes/agent/prewarm.ts +48 -7
  292. package/src/server/routes/fs/action.ts +9 -1
  293. package/src/server/routes/fs/digest.test.ts +100 -0
  294. package/src/server/routes/fs/digest.ts +106 -0
  295. package/src/server/routes/fs/index.ts +2 -0
  296. package/src/server/routes/fs/read.ts +6 -1
  297. package/src/server/routes/harness/custom.test.ts +131 -0
  298. package/src/server/routes/harness/import-action.ts +2 -2
  299. package/src/server/routes/harness/root.ts +41 -8
  300. package/src/server/routes/harness/update.ts +2 -2
  301. package/src/server/routes/panels/bindings.ts +2 -0
  302. package/src/server/routes/panels/settings.test.ts +165 -0
  303. package/src/server/routes/panels/settings.ts +106 -0
  304. package/src/server/routes/schedule/body.ts +14 -0
  305. package/src/server/routes/schedule/index.ts +28 -4
  306. package/src/server/routes/settings/mcp.ts +9 -26
  307. package/src/server/routes/waiting/index.ts +21 -2
  308. package/src/server/routes/waiting/routes.test.ts +21 -0
  309. package/src/shared/lib/chat/composer/delegation.ts +3 -3
  310. package/src/shared/lib/chat/timeline/fork-anchor.test.ts +97 -0
  311. package/src/shared/lib/chat/timeline/fork-anchor.ts +47 -0
  312. package/src/shared/lib/chat/timeline/fork-preview.test.ts +62 -0
  313. package/src/shared/lib/chat/timeline/fork-preview.ts +36 -0
  314. package/src/shared/lib/fs/content-hash.ts +29 -0
  315. package/src/shared/lib/harness/catalog.ts +48 -6
  316. package/src/shared/lib/harness/fork.ts +60 -0
  317. package/src/shared/lib/harness/mcp-facts.test.ts +30 -0
  318. package/src/shared/lib/harness/mcp-facts.ts +65 -0
  319. package/src/shared/lib/harness/menu.test.ts +16 -1
  320. package/src/shared/lib/harness/menu.ts +2 -2
  321. package/src/shared/lib/harness/rewind.ts +6 -6
  322. package/src/shared/lib/harness/session-modes.ts +31 -0
  323. package/src/shared/lib/harness/transcript.test.ts +29 -0
  324. package/src/shared/lib/harness/transcript.ts +19 -0
  325. package/src/shared/lib/notifications/settings.test.ts +21 -0
  326. package/src/shared/lib/notifications/settings.ts +24 -0
  327. package/src/shared/lib/omp/session/prewarm.test.ts +28 -4
  328. package/src/shared/lib/omp/session/prewarm.ts +25 -6
  329. package/src/shared/lib/omp/session/stream-state.server.test.ts +25 -0
  330. package/src/shared/lib/omp/session/stream-state.server.ts +8 -4
  331. package/src/shared/lib/panels/capabilities.test.ts +1 -1
  332. package/src/shared/lib/panels/capabilities.ts +3 -0
  333. package/src/shared/lib/plugins/settings.ts +22 -0
  334. package/src/shared/lib/schedule/parse.test.ts +48 -0
  335. package/src/shared/lib/schedule/parse.ts +69 -45
  336. package/src/shared/lib/schedule/timezone.ts +128 -0
  337. package/src/shared/lib/settings/defaults.ts +2 -0
  338. package/src/shared/lib/ui/toast-duration.test.ts +25 -1
  339. package/src/shared/lib/ui/toast-duration.ts +22 -4
  340. package/src/shared/lib/workspace/refresh-cadence.test.ts +25 -1
  341. package/src/shared/lib/workspace/relative-time.ts +16 -0
  342. package/src/shared/lib/workspace/session-state/store.ts +4 -0
  343. package/src/shared/types/harness.ts +7 -0
  344. package/src/shared/types/omp/agent.ts +6 -0
  345. package/src/shared/types/panels-registry.ts +3 -3
  346. package/src/shared/types/panels.ts +4 -2
  347. package/src/shared/types/schedule.ts +13 -0
  348. package/src/shared/types/settings/state.ts +12 -1
  349. package/src/shared/types/waiting.ts +9 -0
  350. package/src/test-support/file-editor.test-util.ts +70 -5
  351. package/dist/client/static/js/index-p2yw9ywf.css +0 -1
  352. package/src/client/hooks/editor/use-external-change-notice.ts +0 -71
  353. package/src/client/hooks/editor/use-external-change.test.ts +0 -88
  354. package/src/client/hooks/editor/use-external-change.ts +0 -146
@@ -15,7 +15,7 @@
15
15
  */
16
16
 
17
17
  import { describe, expect, test } from 'bun:test';
18
- import { applySelections, modelFromOption } from '@/server/lib/harness/acp/prompt';
18
+ import { applyLaunchSelections, applySelections, modelFromOption } from '@/server/lib/harness/acp/prompt';
19
19
  import type { AcpConfigOption } from '@/server/lib/harness/acp/protocol';
20
20
 
21
21
  function selector(currentValue: string | undefined): AcpConfigOption {
@@ -148,3 +148,72 @@ describe('applySelections', () => {
148
148
  )).rejects.toThrow('dsh refused model "["kenari","qwen3-8-27b:free"]"');
149
149
  });
150
150
  });
151
+
152
+ describe('applyLaunchSelections', () => {
153
+ const legacy = (modeIds: string[]): AcpConfigOption => ({
154
+ id: 'mode',
155
+ category: 'mode',
156
+ type: 'select',
157
+ currentValue: modeIds[0],
158
+ options: modeIds.map((value) => ({ value })),
159
+ });
160
+
161
+ test('a mode selector is written through setConfig, not set_mode', async () => {
162
+ const writes: string[] = [];
163
+ const setModes: string[] = [];
164
+ await applyLaunchSelections(
165
+ {
166
+ configOptions: [legacy(['default', 'plan'])],
167
+ runModel: null,
168
+ setConfig: async (id, value) => {
169
+ writes.push(`${id}=${String(value)}`);
170
+ },
171
+ setMode: async (mode) => {
172
+ setModes.push(mode);
173
+ },
174
+ },
175
+ { model: null, thinking: null, mode: 'plan' },
176
+ );
177
+ expect(writes).toEqual(['mode=plan']);
178
+ // The config selector supersedes the older list: calling both would write
179
+ // the same mode twice, in two different verbs.
180
+ expect(setModes).toEqual([]);
181
+ });
182
+
183
+ test('an agent with only the older modes list moves through set_mode', async () => {
184
+ // This is the branch the claim relies on: a prewarmed session handshaked
185
+ // with no picks, so the mode the operator chose arrives here, one write
186
+ // after the fact.
187
+ const setModes: string[] = [];
188
+ await applyLaunchSelections(
189
+ {
190
+ configOptions: [],
191
+ modes: { currentModeId: 'default', availableModes: [{ id: 'default', name: 'Default' }, { id: 'plan', name: 'Plan' }] },
192
+ runModel: null,
193
+ setConfig: async () => {},
194
+ setMode: async (mode) => {
195
+ setModes.push(mode);
196
+ },
197
+ },
198
+ { model: null, thinking: null, mode: 'plan' },
199
+ );
200
+ expect(setModes).toEqual(['plan']);
201
+ });
202
+
203
+ test('a mode the agent never advertised is not written', async () => {
204
+ const setModes: string[] = [];
205
+ await applyLaunchSelections(
206
+ {
207
+ configOptions: [],
208
+ modes: { currentModeId: 'default', availableModes: [{ id: 'default', name: 'Default' }] },
209
+ runModel: null,
210
+ setConfig: async () => {},
211
+ setMode: async (mode) => {
212
+ setModes.push(mode);
213
+ },
214
+ },
215
+ { model: null, thinking: null, mode: 'architect' },
216
+ );
217
+ expect(setModes).toEqual([]);
218
+ });
219
+ });
@@ -16,7 +16,7 @@
16
16
  * approve.
17
17
  */
18
18
 
19
- import { acpOptionValues, type AcpConfigOption } from '@/server/lib/harness/acp/protocol';
19
+ import { acpOptionValues, type AcpConfigOption, type AcpSessionModeState } from '@/server/lib/harness/acp/protocol';
20
20
 
21
21
  /** The selector in a `configOptions` list for one ACP category. */
22
22
  export function configOption(options: AcpConfigOption[], category: string): AcpConfigOption | undefined {
@@ -107,6 +107,37 @@ export interface ConfigSelectionHost {
107
107
  readonly harness?: string;
108
108
  }
109
109
 
110
+ /** The host plus the older Session Modes API, for the launch picks. */
111
+ export interface LaunchSelectionHost extends ConfigSelectionHost {
112
+ readonly modes?: AcpSessionModeState | null;
113
+ /** `session/set_mode`; present only when the session can speak it. */
114
+ setMode?: (modeId: string) => Promise<unknown>;
115
+ }
116
+
117
+ /**
118
+ * Apply the picks a spawn carries: the config selectors, then the legacy
119
+ * `modes` verb for an agent that publishes only that list.
120
+ *
121
+ * The ONE place a launch's picks are applied — a cold spawn and a prewarmed
122
+ * process both reach it through `handshakeAcpSession`, which is what keeps the
123
+ * two from disagreeing about the mode an agent that speaks only
124
+ * `session/set_mode` ends up in.
125
+ */
126
+ export async function applyLaunchSelections(
127
+ host: LaunchSelectionHost,
128
+ wanted: ConfigSelections,
129
+ ): Promise<void> {
130
+ await applySelections(host, wanted);
131
+ if (
132
+ wanted.mode
133
+ && !configOption(host.configOptions, 'mode')
134
+ && host.modes?.availableModes.some((entry) => entry.id === wanted.mode)
135
+ && host.setMode
136
+ ) {
137
+ await host.setMode(wanted.mode).catch(() => {});
138
+ }
139
+ }
140
+
110
141
  /**
111
142
  * Apply the model/thinking/mode picks with one config write each.
112
143
  *
@@ -138,6 +138,29 @@ export interface AcpConfigOption {
138
138
  options?: ({ value: string; name?: string; description?: string } | { group: string; name?: string; options: { value: string; name?: string }[] })[];
139
139
  }
140
140
 
141
+ /**
142
+ * One MCP server as `session/new|load|resume|fork` carries it.
143
+ *
144
+ * stdio is the ACP baseline; `http` is the typed variant an agent advertises
145
+ * through `mcpCapabilities.http`. `env` and `headers` are LISTS of name/value
146
+ * pairs on the wire, not maps — a map would lose ordering and duplicate keys.
147
+ */
148
+ export interface AcpMcpServerStdio {
149
+ name: string;
150
+ command: string;
151
+ args: string[];
152
+ env: Array<{ name: string; value: string }>;
153
+ }
154
+
155
+ export interface AcpMcpServerHttp {
156
+ type: 'http';
157
+ name: string;
158
+ url: string;
159
+ headers: Array<{ name: string; value: string }>;
160
+ }
161
+
162
+ export type AcpMcpServer = AcpMcpServerStdio | AcpMcpServerHttp;
163
+
141
164
  export interface AcpSessionNewResult {
142
165
  sessionId: string;
143
166
  configOptions?: AcpConfigOption[];
@@ -181,6 +181,32 @@ describe('handshakeAcpSession', () => {
181
181
  expect(session.sessionId).toBe('forked-id');
182
182
  });
183
183
 
184
+ test('a fork point travels to the agent as the request _meta', async () => {
185
+ const seen: unknown[] = [];
186
+ const proc = processDouble({
187
+ async forkSession(
188
+ sessionId: string,
189
+ _cwd: string,
190
+ _timeoutMs?: number,
191
+ _target?: Record<string, unknown>,
192
+ meta?: Record<string, unknown>,
193
+ ) {
194
+ seen.push({ sessionId, meta });
195
+ return { sessionId: 'forked-id' };
196
+ },
197
+ });
198
+ const meta = { jetbrains: { air: { fork: { version: 1, messageId: 'a2' } } } };
199
+ await handshakeAcpSession(
200
+ target(),
201
+ proc,
202
+ { model: null, thinking: null, mode: null },
203
+ undefined,
204
+ 'agent-1',
205
+ meta,
206
+ );
207
+ expect(seen).toEqual([{ sessionId: 'agent-1', meta }]);
208
+ });
209
+
184
210
  test('a process with no fork verb refuses instead of creating an empty session', async () => {
185
211
  const proc = processDouble();
186
212
  await expect(
@@ -25,12 +25,13 @@
25
25
  */
26
26
 
27
27
  import { newSessionAfterActivation } from '@/server/lib/harness/acp/activation';
28
- import { applySelections, configOption, modelFromOption } from '@/server/lib/harness/acp/prompt';
28
+ import { applyLaunchSelections, configOption, modelFromOption } from '@/server/lib/harness/acp/prompt';
29
29
  import { capabilitiesFrom } from '@/server/lib/harness/launch';
30
30
  import type {
31
31
  AcpAgentCommand,
32
32
  AcpConfigOption,
33
33
  AcpInitializeResult,
34
+ AcpMcpServer,
34
35
  AcpProtocolVersion,
35
36
  AcpSessionModeState,
36
37
  AcpSessionNewResult,
@@ -41,18 +42,20 @@ import type { HarnessId } from '@/shared/lib/harness/catalog';
41
42
  /** The process slice a handshake drives; `AcpProcess` satisfies it as-is. */
42
43
  export interface AcpHandshakeProcess {
43
44
  initialize(params?: Record<string, unknown>, timeoutMs?: number): Promise<AcpInitializeResult>;
44
- loadSession(sessionId: string, cwd: string, timeoutMs?: number): Promise<unknown>;
45
- newSession(cwd: string, timeoutMs?: number): Promise<AcpSessionNewResult>;
45
+ loadSession(sessionId: string, cwd: string, timeoutMs?: number, mcpServers?: AcpMcpServer[]): Promise<unknown>;
46
+ newSession(cwd: string, timeoutMs?: number, mcpServers?: AcpMcpServer[]): Promise<AcpSessionNewResult>;
46
47
  /** The negotiated major; absent on a test double, which is a v1 double. */
47
48
  readonly protocolVersion?: AcpProtocolVersion;
48
49
  /** `session/resume`; absent on a process double used by older tests. */
49
- resumeSession?(sessionId: string, cwd: string, timeoutMs?: number): Promise<unknown>;
50
+ resumeSession?(sessionId: string, cwd: string, timeoutMs?: number, mcpServers?: AcpMcpServer[]): Promise<unknown>;
50
51
  /** `session/fork`; absent on a process double used by older tests. */
51
52
  forkSession?(
52
53
  sessionId: string,
53
54
  cwd: string,
54
55
  timeoutMs?: number,
55
56
  target?: Record<string, unknown>,
57
+ meta?: Record<string, unknown>,
58
+ mcpServers?: AcpMcpServer[],
56
59
  ): Promise<AcpSessionNewResult>;
57
60
  }
58
61
 
@@ -73,6 +76,8 @@ export interface AcpHandshakeTarget {
73
76
  acceptsImages?: boolean;
74
77
  /** Initial slash commands from a v2 setup response. */
75
78
  agentCommands?: AcpAgentCommand[];
79
+ /** MCP servers every session request carries; empty when none are configured. */
80
+ mcpServers?: AcpMcpServer[];
76
81
  /** Called as soon as `initialize` answers, before any session request, so a
77
82
  * v2 resume snapshot can open a turn. */
78
83
  onProtocol?(version: AcpProtocolVersion): void;
@@ -91,13 +96,15 @@ export async function handshakeAcpSession(
91
96
  wanted: AcpHandshakeSelections,
92
97
  sessionIdToLoad?: string,
93
98
  forkFromSessionId?: string,
99
+ forkMeta?: Record<string, unknown>,
94
100
  ): Promise<void> {
95
101
  const init = await proc.initialize(undefined, 60_000);
96
102
  target.onProtocol?.(init.protocolVersion === 2 ? 2 : 1);
97
103
  /** opencode's plugin activation gate: the first `session/new`s refuse with
98
104
  * `ServiceUnavailableError` until the agent's plugins finish booting. */
105
+ const mcpServers = target.mcpServers ?? [];
99
106
  const newSession = (cwd: string, timeoutMs?: number) =>
100
- newSessionAfterActivation(target.harness, cwd, (dir, ms) => proc.newSession(dir, ms), {
107
+ newSessionAfterActivation(target.harness, cwd, (dir, ms) => proc.newSession(dir, ms, mcpServers), {
101
108
  ...(timeoutMs !== undefined ? { perAttemptMs: timeoutMs } : {}),
102
109
  });
103
110
  let session: AcpSessionNewResult;
@@ -118,6 +125,10 @@ export async function handshakeAcpSession(
118
125
  // required" for a request it cannot place. Other harnesses reject an
119
126
  // unknown `target`, so it is sent only where it is understood.
120
127
  target.harness === 'zcode' ? { kind: 'latestCheckpoint' } : undefined,
128
+ // claude-agent-acp's AIR extension: the fork point, when the caller has
129
+ // one. An agent that does not read it ignores the key and forks whole.
130
+ forkMeta,
131
+ mcpServers,
121
132
  );
122
133
  } else if (sessionIdToLoad) {
123
134
  // ACP gates restoration on the AGENT's advertised capability: `loadSession`
@@ -131,13 +142,13 @@ export async function handshakeAcpSession(
131
142
  // nothing unless `replayFrom` asks, which is exactly what Kabmo wants —
132
143
  // its own transcript is already on screen.
133
144
  ? await (proc.resumeSession
134
- ? proc.resumeSession(sessionIdToLoad, target.cwd, 120_000)
145
+ ? proc.resumeSession(sessionIdToLoad, target.cwd, 120_000, mcpServers)
135
146
  : Promise.reject(new Error(`${target.harness} cannot resume a session`)))
136
147
  : caps.loadSession === true
137
- ? await loadReplacement(proc, newSession, sessionIdToLoad, target.cwd)
148
+ ? await loadReplacement(proc, newSession, sessionIdToLoad, target.cwd, mcpServers)
138
149
  : caps.sessionCapabilities?.resume != null
139
150
  ? await (proc.resumeSession
140
- ? proc.resumeSession(sessionIdToLoad, target.cwd, 120_000)
151
+ ? proc.resumeSession(sessionIdToLoad, target.cwd, 120_000, mcpServers)
141
152
  : Promise.reject(new Error(`${target.harness} cannot resume a session`)))
142
153
  : null;
143
154
  if (restored === null) {
@@ -161,17 +172,7 @@ export async function handshakeAcpSession(
161
172
  if (session.availableCommands) target.agentCommands = session.availableCommands;
162
173
  target.runModel = modelFromOption(configOption(target.configOptions, 'model'), target.harness);
163
174
  target.capabilities = capabilitiesFrom(init, target.configOptions, { usage: false, plan: false }, target.modes);
164
- await applySelections(target, wanted);
165
- // A mode the composer asked for, on an agent that publishes only the older
166
- // `modes` list: `session/set_mode` is the only way to apply it.
167
- if (
168
- wanted.mode
169
- && !configOption(target.configOptions, 'mode')
170
- && target.modes?.availableModes.some((entry) => entry.id === wanted.mode)
171
- && target.setMode
172
- ) {
173
- await target.setMode(wanted.mode).catch(() => {});
174
- }
175
+ await applyLaunchSelections(target, wanted);
175
176
  }
176
177
 
177
178
  /**
@@ -186,7 +187,8 @@ async function loadReplacement(
186
187
  create: (cwd: string, timeoutMs?: number) => Promise<AcpSessionNewResult>,
187
188
  sessionId: string,
188
189
  cwd: string,
190
+ mcpServers: AcpMcpServer[],
189
191
  ): Promise<unknown> {
190
- await proc.loadSession(sessionId, cwd, 120_000);
192
+ await proc.loadSession(sessionId, cwd, 120_000, mcpServers);
191
193
  return (await create(cwd).catch(() => null)) ?? { sessionId };
192
194
  }
@@ -14,11 +14,19 @@
14
14
 
15
15
  import type { ApprovalMode } from '@/shared/lib/omp/config/access-mode';
16
16
  import type { HarnessId } from '@/shared/lib/harness/catalog';
17
+ import type { AcpProcess } from '@/server/lib/harness/acp/client';
18
+ import type { AcpMcpServer } from '@/server/lib/harness/acp/protocol';
17
19
 
18
20
  export interface AcpSessionOptions {
19
21
  harness: HarnessId;
20
22
  command: string[];
21
23
  env?: Record<string, string>;
24
+ /**
25
+ * A process that has already been spawned and `initialize`d — a prewarmed
26
+ * agent. The session adopts it, so the handshake it runs costs only
27
+ * `session/new` and the config writes; the frame sinks are re-bound here.
28
+ */
29
+ process?: AcpProcess;
22
30
  /** Provider/model this session starts on, applied with
23
31
  * `session/set_config_option` right after `session/new`. */
24
32
  model?: { provider: string; modelId: string } | null;
@@ -30,4 +38,12 @@ export interface AcpSessionOptions {
30
38
  /** Quiet window before the child is reclaimed; defaults to the omp window so
31
39
  * both transports release an idle agent after the same time. */
32
40
  idleDestroyMs?: number;
41
+ /**
42
+ * MCP servers every `session/new|load|resume|fork` carries.
43
+ *
44
+ * ACP is the delivery for every harness but omp's RPC mode, so this is where
45
+ * the settings list reaches an agent. Empty means "none configured", which is
46
+ * also what an audit reader passes.
47
+ */
48
+ mcpServers?: AcpMcpServer[];
33
49
  }
@@ -0,0 +1,43 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Which agent process a session drives: the one it spawns, or a prewarmed one
8
+ * it adopts.
9
+ *
10
+ * Split from `session.ts` for the per-file ceiling, and the decision is worth
11
+ * naming: a prewarmed child was spawned before this session existed, so its
12
+ * notifications, agent→client requests and exit notice are pointing at nobody.
13
+ * Adopting means re-binding those sinks — after that the process is
14
+ * indistinguishable from a cold spawn, and its cached `initialize` is reused.
15
+ */
16
+
17
+ import { AcpProcess, type AcpClientOptions } from '@/server/lib/harness/acp/client';
18
+ import { withGatewayCompatibility } from '@/server/lib/harness/acp/gateway-env';
19
+ import type { AcpSessionOptions } from '@/server/lib/harness/acp/session-options';
20
+
21
+ /** The frame sinks a session supplies; `AcpProcess` re-binds them on adoption. */
22
+ export type SessionFrameSinks = Pick<
23
+ AcpClientOptions,
24
+ 'onNotification' | 'onClientRequest' | 'onExit' | 'onStderr'
25
+ >;
26
+
27
+ export function openSessionProcess(
28
+ options: AcpSessionOptions,
29
+ cwd: string,
30
+ sinks: SessionFrameSinks,
31
+ ): AcpProcess {
32
+ if (options.process) {
33
+ options.process.attachSinks(sinks);
34
+ return options.process;
35
+ }
36
+ const env = withGatewayCompatibility(options.harness, options.env);
37
+ return new AcpProcess({
38
+ command: options.command,
39
+ cwd,
40
+ ...(env ? { env } : {}),
41
+ ...sinks,
42
+ });
43
+ }
@@ -21,11 +21,11 @@
21
21
  */
22
22
 
23
23
  import { AcpProcess } from '@/server/lib/harness/acp/client';
24
+ import { openSessionProcess } from '@/server/lib/harness/acp/session-process';
24
25
  import { AcpTurns, type AcpTurnEndInfo } from '@/server/lib/harness/acp/turn';
25
26
  import { AcpFrameMapper } from '@/server/lib/harness/acp/frames';
26
27
  import type { AcpConfigOption, AcpId, AcpProtocolVersion, AcpSessionModeState } from '@/server/lib/harness/acp/protocol';
27
28
  import { promptBlocks } from '@/server/lib/harness/acp/prompt';
28
- import { withGatewayCompatibility } from '@/server/lib/harness/acp/gateway-env';
29
29
  import { adoptConfigAnswer, publishConfigChange, settlePermissionDialog, stampMessageModel } from '@/server/lib/harness/acp/session-config';
30
30
  import { beginAcpTurn, settleAcpTurn } from '@/server/lib/harness/acp/session-turns';
31
31
  import { driveAcpGoalAfterTurn } from '@/server/lib/harness/acp/acp-goal-driver.server';
@@ -51,6 +51,7 @@ import { DEFAULT_APPROVAL_MODE, isApprovalMode, type ApprovalMode } from '@/shar
51
51
  import { dispatchCommand, type AcpCommandHost } from '@/server/lib/harness/acp/commands';
52
52
  import { markStreamStatus } from '@/shared/lib/omp/session/stream-state.server';
53
53
  import type { AcpSessionOptions } from '@/server/lib/harness/acp/session-options';
54
+ import type { AcpMcpServer } from '@/server/lib/harness/acp/protocol';
54
55
  import type { HarnessCapabilities } from '@/server/lib/harness/capabilities';
55
56
  import type { HarnessSession } from '@/server/lib/harness/session';
56
57
  import type { HarnessId } from '@/shared/lib/harness/catalog';
@@ -89,6 +90,8 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
89
90
  modes: AcpSessionModeState | null = null;
90
91
  /** Whether the agent advertised `promptCapabilities.image`. */
91
92
  acceptsImages = false;
93
+ /** MCP servers every session request carries; empty when none are configured. */
94
+ readonly mcpServers: AcpMcpServer[];
92
95
  private readonly proc: AcpProcess;
93
96
  /** The quiet-window reclaim; the rules live in `session-idle.ts`. */
94
97
  readonly idle: IdleReaper;
@@ -105,11 +108,7 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
105
108
  constructor(options: AcpSessionOptions, cwd: string) {
106
109
  this.harness = options.harness;
107
110
  this.cwd = cwd;
108
- const env = withGatewayCompatibility(options.harness, options.env);
109
- this.proc = new AcpProcess({
110
- command: options.command,
111
- cwd,
112
- ...(env ? { env } : {}),
111
+ this.proc = openSessionProcess(options, cwd, {
113
112
  onNotification: (method, params) => this.onNotification(method, params),
114
113
  onClientRequest: (id, method, params) => this.onClientRequest(id, method, params),
115
114
  onExit: (info) => this.onExit(info),
@@ -140,6 +139,7 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
140
139
  // omp's wrapper.
141
140
  onTurnEnd: (info) => this.onTurnEnded(info),
142
141
  });
142
+ this.mcpServers = options.mcpServers ?? [];
143
143
  this.requestedModel = options.model ?? null;
144
144
  this.requestedThinking = options.thinkingLevel ?? null;
145
145
  this.requestedMode = options.mode ?? null;
@@ -150,13 +150,14 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
150
150
  private readonly requestedThinking: string | null;
151
151
  private readonly requestedMode: string | null;
152
152
  /** `initialize` + `session/new|load|resume`, then the requested selections. */
153
- async start(sessionIdToLoad?: string, forkFromSessionId?: string): Promise<{ sessionId: string }> {
153
+ async start(sessionIdToLoad?: string, forkFromSessionId?: string, forkMeta?: Record<string, unknown>): Promise<{ sessionId: string }> {
154
154
  await handshakeAcpSession(
155
155
  this,
156
156
  this.proc,
157
157
  { model: this.requestedModel, thinking: this.requestedThinking, mode: this.requestedMode },
158
158
  sessionIdToLoad,
159
159
  forkFromSessionId,
160
+ forkMeta,
160
161
  );
161
162
  // A slow handshake is not idleness: the window starts once it is usable.
162
163
  this.idle.reset(true);
@@ -164,6 +165,8 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
164
165
  }
165
166
 
166
167
  get protocol(): AcpProtocolVersion { return this.proc.protocolVersion === 2 ? 2 : 1; }
168
+ /** The OS pid of the agent child, for the Stats panel's lease. */
169
+ get pid(): number | undefined { return this.proc.pid; }
167
170
  /** Set by the handshake as soon as `initialize` answers. */
168
171
  onProtocol(version: AcpProtocolVersion): void { this.turns.completion = version === 2 ? 'state' : 'response'; }
169
172
  isAlive(): boolean { return !this.destroyed && this.proc.isAlive; }
@@ -308,11 +311,7 @@ export class AcpSession implements HarnessSession, AcpCommandHost {
308
311
  /** Answer an agent→client request with a result (cancellation uses it). */
309
312
  respond(id: AcpId, result: unknown): void { this.proc.respond(id, result); }
310
313
  /** Agent→client requests: every branch answers or refuses — an unanswered call parks the turn. */
311
- private onClientRequest(
312
- id: AcpId,
313
- method: string,
314
- params: Record<string, unknown>,
315
- ): Promise<AcpClientRequestAnswer> {
314
+ private onClientRequest(id: AcpId, method: string, params: Record<string, unknown>): Promise<AcpClientRequestAnswer> {
316
315
  this.idle.reset();
317
316
  return handleAcpClientRequest(this, id, method, params);
318
317
  }
@@ -0,0 +1,129 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The agent child and its pipes: spawn, read lines, keep the stderr tail, and
8
+ * dispose the process group.
9
+ *
10
+ * Split from `client.ts` for the repo's per-file ceiling, and the seam is real:
11
+ * the transport OWNS a process, and this module owns what the OS sees — the
12
+ * spawn, the two readers, the exit notice and the kill escalation. `client.ts`
13
+ * keeps framing, the pending-call table and the verbs.
14
+ *
15
+ * The stderr tail exists because `exited (code 1)` tells a reader nothing: a
16
+ * shadowed or corrupt binary usually explains itself on stderr, and that text is
17
+ * the only actionable part of a failed spawn.
18
+ */
19
+
20
+ import type { Subprocess } from 'bun';
21
+ import { readLines } from '@/server/lib/omp/rpc/lines';
22
+ import { killProcessTree } from '@/server/lib/lifecycle/kill-tree';
23
+ import { stripKabmoHostEnv, withToolchainPath } from '@kabmo-labs/kabmo-sdk';
24
+
25
+ const STDERR_TAIL_LIMIT = 8_000;
26
+
27
+ export interface AgentStdioOptions {
28
+ command: string[];
29
+ cwd: string;
30
+ env?: Record<string, string>;
31
+ }
32
+
33
+ export interface AgentStdioHandlers {
34
+ /** One stdout line, already trimmed of its newline — JSON or a log line. */
35
+ onLine: (line: string) => void;
36
+ onStderr?: (line: string) => void;
37
+ /** The child is gone. Fires once, after `exited`. */
38
+ onExit: (info: { code: number | null; stderrTail: string }) => void;
39
+ }
40
+
41
+ export class AgentStdio {
42
+ readonly child: Subprocess<'pipe', 'pipe', 'pipe'>;
43
+ #tail = '';
44
+
45
+ constructor(options: AgentStdioOptions, handlers: AgentStdioHandlers) {
46
+ const [command, ...args] = options.command;
47
+ if (!command) throw new Error('ACP launch command is empty');
48
+ const childEnv = withToolchainPath(
49
+ stripKabmoHostEnv({ ...Bun.env, ...options.env }, process.platform),
50
+ process.platform,
51
+ );
52
+ try {
53
+ this.child = Bun.spawn({
54
+ cmd: [command, ...args],
55
+ cwd: options.cwd,
56
+ env: childEnv,
57
+ stdin: 'pipe',
58
+ stdout: 'pipe',
59
+ stderr: 'pipe',
60
+ windowsHide: true,
61
+ // Its own process group, exactly like the omp child: an ACP adapter
62
+ // spawns ITS own agent binary (codex-acp runs codex, pi-acp runs pi),
63
+ // so killing only the adapter leaves the real agent running.
64
+ detached: process.platform !== 'win32',
65
+ });
66
+ } catch (error) {
67
+ throw new Error(
68
+ `Could not start ${command}: ${error instanceof Error ? error.message : String(error)}`,
69
+ );
70
+ }
71
+
72
+ void readLines(this.child.stdout, (line) => handlers.onLine(line));
73
+ void readLines(this.child.stderr, (line) => {
74
+ this.#tail = `${this.#tail}${line}\n`.slice(-STDERR_TAIL_LIMIT);
75
+ handlers.onStderr?.(line);
76
+ });
77
+ void this.child.exited.then((code) => {
78
+ handlers.onExit({ code, stderrTail: this.#tail });
79
+ });
80
+ }
81
+
82
+ get stderrTail(): string {
83
+ return this.#tail;
84
+ }
85
+
86
+ get pid(): number | undefined {
87
+ return this.child.pid ?? undefined;
88
+ }
89
+
90
+ /** Write one already-serialized frame. A closed pipe is not an error here:
91
+ * the `exited` notice is what reports it, and throwing would wedge the
92
+ * caller's queue. */
93
+ write(line: string): void {
94
+ try {
95
+ this.child.stdin.write(line);
96
+ } catch {
97
+ // Closed pipe: reported by `exited`.
98
+ }
99
+ }
100
+
101
+ async flush(): Promise<void> {
102
+ try {
103
+ await this.child.stdin.flush();
104
+ } catch {
105
+ // Closed pipe: reported by `exited`.
106
+ }
107
+ }
108
+
109
+ /** Graceful then forceful shutdown of the whole process group. */
110
+ async dispose(gracePeriodMs = 5_000): Promise<void> {
111
+ const exited = this.child.exited.then(() => undefined);
112
+ try {
113
+ this.child.stdin.end();
114
+ } catch {
115
+ // Already closed.
116
+ }
117
+ const term = setTimeout(() => {
118
+ killProcessTree(this.child.pid, false, 'SIGTERM');
119
+ }, gracePeriodMs);
120
+ const kill = setTimeout(() => {
121
+ killProcessTree(this.child.pid, true, 'SIGKILL');
122
+ }, gracePeriodMs * 2);
123
+ term.unref?.();
124
+ kill.unref?.();
125
+ await exited;
126
+ clearTimeout(term);
127
+ clearTimeout(kill);
128
+ }
129
+ }