@kabmo-labs/kabmo 0.24.0 → 0.26.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 (325) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +585 -512
  3. package/dist/client/static/js/{index-jcr5twtp.js → index-95b3n20k.js} +1105 -1207
  4. package/dist/client/static/js/index-p2yw9ywf.css +1 -0
  5. package/package.json +2 -4
  6. package/src/cli/lib/args.js +24 -1
  7. package/src/cli/lib/args.test.js +16 -0
  8. package/src/cli/lib/commands/session.js +233 -0
  9. package/src/cli/lib/commands/session.test.js +103 -0
  10. package/src/cli/main.js +1 -1
  11. package/src/client/components/common/ComposerPicker.tsx +3 -0
  12. package/src/client/components/common/code-surface/shiki.test.ts +82 -0
  13. package/src/client/components/common/code-surface/shiki.ts +28 -7
  14. package/src/client/components/common/session-actions-menu/index.tsx +59 -2
  15. package/src/client/components/common/session-branch/BranchGuides.tsx +93 -0
  16. package/src/client/components/common/session-branch/SubagentRow.tsx +77 -0
  17. package/src/client/components/common/session-branch/index.tsx +169 -0
  18. package/src/client/components/common/session-branch/session-branch.test.tsx +240 -0
  19. package/src/client/components/common/session-branch/style.ts +29 -0
  20. package/src/client/components/common/session-row/StatusSlot.tsx +17 -5
  21. package/src/client/components/common/session-row/index.tsx +28 -3
  22. package/src/client/components/common/session-row/session-row.test.tsx +11 -0
  23. package/src/client/components/common/session-state-provider/index.tsx +1 -1
  24. package/src/client/components/layout/desktop-layout/resizer/separator-drag.ts +3 -3
  25. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +70 -61
  26. package/src/client/components/layout/session-sidebar/SessionItem.batch.test.ts +3 -3
  27. package/src/client/components/layout/session-sidebar/SessionItem.test.ts +25 -2
  28. package/src/client/components/layout/session-sidebar/SessionItem.tsx +35 -7
  29. package/src/client/components/layout/session-sidebar/about-modal/HarnessRow.tsx +261 -0
  30. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +39 -198
  31. package/src/client/components/layout/session-sidebar/about-modal/HarnessTableLog.test.tsx +114 -0
  32. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.test.tsx +130 -0
  33. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.tsx +128 -0
  34. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +56 -0
  35. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +44 -36
  36. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +62 -47
  37. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +63 -50
  38. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +5 -0
  39. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +37 -12
  40. package/src/client/components/settings/Sidebar.tsx +1 -1
  41. package/src/client/components/settings/categories/NotificationSettings.test.tsx +92 -0
  42. package/src/client/components/settings/categories/NotificationSettings.tsx +112 -2
  43. package/src/client/components/settings/categories/harness-settings/HarnessCard.tsx +1 -1
  44. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +94 -0
  45. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +31 -5
  46. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +64 -70
  47. package/src/client/components/workspace/chat-timeline/ComposerDockFrame.tsx +35 -0
  48. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +128 -122
  49. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +22 -1
  50. package/src/client/components/workspace/chat-timeline/MessageList.tsx +11 -5
  51. package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +10 -0
  52. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +12 -3
  53. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +3 -0
  54. package/src/client/components/workspace/chat-timeline/chat-input/AttachmentToolbar.tsx +2 -0
  55. package/src/client/components/workspace/chat-timeline/chat-input/ModeToggles.tsx +15 -1
  56. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +85 -0
  57. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +84 -0
  58. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +2 -0
  59. package/src/client/components/workspace/chat-timeline/chat-input/modes-props.ts +5 -0
  60. package/src/client/components/workspace/chat-timeline/composer-dock-frame.test.tsx +155 -0
  61. package/src/client/components/workspace/chat-timeline/index.tsx +11 -20
  62. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +115 -0
  63. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +173 -0
  64. package/src/client/components/workspace/chat-timeline/target-picker/parent-session-options.test.ts +49 -0
  65. package/src/client/components/workspace/terminal-panel/KeyBar.tsx +10 -8
  66. package/src/client/components/workspace/terminal-panel/{RealtimeXtermView.tsx → RealtimeTerminalView.tsx} +51 -58
  67. package/src/client/components/workspace/terminal-panel/fit.test.ts +37 -0
  68. package/src/client/components/workspace/terminal-panel/fit.ts +64 -0
  69. package/src/client/components/workspace/terminal-panel/fonts.test.ts +161 -0
  70. package/src/client/components/workspace/terminal-panel/fonts.ts +164 -0
  71. package/src/client/components/workspace/terminal-panel/grid.test.ts +52 -0
  72. package/src/client/components/workspace/terminal-panel/grid.ts +118 -0
  73. package/src/client/components/workspace/terminal-panel/index.tsx +25 -21
  74. package/src/client/components/workspace/terminal-panel/mount.ts +247 -223
  75. package/src/client/components/workspace/terminal-panel/navigation.test.ts +54 -0
  76. package/src/client/components/workspace/terminal-panel/navigation.ts +47 -0
  77. package/src/client/data/settings/omp-schema.json +1 -1
  78. package/src/client/data/theme/terminal.test.ts +25 -0
  79. package/src/client/data/theme/terminal.ts +96 -79
  80. package/src/client/hooks/chat/composer/items.test.ts +31 -26
  81. package/src/client/hooks/chat/composer/pick-mapping.test.ts +42 -0
  82. package/src/client/hooks/chat/omp/folder-auto-expand.ts +1 -1
  83. package/src/client/hooks/chat/omp/pending-adoption.ts +51 -0
  84. package/src/client/hooks/chat/omp/pending-child.test.ts +73 -0
  85. package/src/client/hooks/chat/omp/pending-entry.ts +59 -0
  86. package/src/client/hooks/chat/omp/pending-rows.ts +6 -2
  87. package/src/client/hooks/chat/omp/pending-sessions.test.ts +1 -2
  88. package/src/client/hooks/chat/omp/pending-sessions.ts +45 -69
  89. package/src/client/hooks/chat/omp/pending-waiting.ts +1 -1
  90. package/src/client/hooks/chat/omp/prompt-send.test.ts +7 -7
  91. package/src/client/hooks/chat/omp/prompt-send.ts +26 -14
  92. package/src/client/hooks/chat/omp/run-switch.ts +1 -1
  93. package/src/client/hooks/chat/omp/session-list.tsx +4 -0
  94. package/src/client/hooks/chat/subagents/roster.ts +122 -0
  95. package/src/client/hooks/chat/timeline/child-spawn.test.ts +55 -0
  96. package/src/client/hooks/chat/timeline/child-spawn.ts +45 -0
  97. package/src/client/hooks/chat/timeline/fork-request.test.ts +54 -0
  98. package/src/client/hooks/chat/timeline/fork-request.ts +43 -0
  99. package/src/client/hooks/chat/timeline/mode-availability.test.ts +1 -1
  100. package/src/client/hooks/chat/timeline/mode-availability.ts +33 -0
  101. package/src/client/hooks/chat/timeline/mode-markers.ts +7 -1
  102. package/src/client/hooks/chat/timeline/mode-post.ts +15 -3
  103. package/src/client/hooks/chat/timeline/modes-contract.ts +9 -4
  104. package/src/client/hooks/chat/timeline/modes.test.ts +56 -18
  105. package/src/client/hooks/chat/timeline/modes.ts +42 -29
  106. package/src/client/hooks/chat/timeline/pending-branch.ts +205 -0
  107. package/src/client/hooks/chat/timeline/pending-dispatch.ts +253 -0
  108. package/src/client/hooks/chat/timeline/prompt-text.test.ts +34 -1
  109. package/src/client/hooks/chat/timeline/prompt-text.ts +47 -20
  110. package/src/client/hooks/chat/timeline/send-execute.test.ts +39 -0
  111. package/src/client/hooks/chat/timeline/send-helpers.ts +30 -1
  112. package/src/client/hooks/chat/timeline/send-steer.test.ts +3 -1
  113. package/src/client/hooks/chat/timeline/send.test-util.ts +7 -1
  114. package/src/client/hooks/chat/timeline/send.test.ts +3 -1
  115. package/src/client/hooks/chat/timeline/send.ts +48 -133
  116. package/src/client/hooks/chat/timeline/session-harness.ts +6 -0
  117. package/src/client/hooks/chat/timeline/stop-with-queue.ts +42 -0
  118. package/src/client/hooks/chat/timeline/use-fork-session.ts +58 -0
  119. package/src/client/hooks/models/use-harness-update.test.ts +286 -0
  120. package/src/client/hooks/models/use-harness-update.ts +250 -0
  121. package/src/client/hooks/ui/input-required-alert.ts +12 -5
  122. package/src/client/hooks/ui/notifications.ts +45 -0
  123. package/src/client/hooks/ui/run-outcome-alert.ts +48 -0
  124. package/src/client/hooks/workspace/expanded-sessions.ts +36 -7
  125. package/src/client/hooks/workspace/terminal/index.ts +17 -3
  126. package/src/client/hooks/workspace/terminal/socket.ts +9 -4
  127. package/src/client/lib/native/open-session.ts +33 -0
  128. package/src/client/lib/notifications/os.test.ts +125 -0
  129. package/src/client/lib/notifications/os.ts +130 -0
  130. package/src/client/lib/plugins/sidebar-bridge.ts +2 -20
  131. package/src/client/lib/router/open-session.test.ts +75 -0
  132. package/src/client/lib/router/open-session.ts +34 -0
  133. package/src/client/lib/session-tree.test.ts +50 -0
  134. package/src/client/lib/session-tree.ts +59 -0
  135. package/src/client/lib/signals.ts +5 -1
  136. package/src/client/main.tsx +6 -0
  137. package/src/client/tailwind.css +17 -11
  138. package/src/server/index.ts +2 -0
  139. package/src/server/lib/auth/guard.ts +10 -0
  140. package/src/server/lib/btw/session-copy.server.ts +6 -44
  141. package/src/server/lib/btw/session-copy.test.ts +2 -1
  142. package/src/server/lib/db/schema.ts +5 -0
  143. package/src/server/lib/db/seed-terminal.test.ts +1 -1
  144. package/src/server/lib/db/seed.test.ts +1 -1
  145. package/src/server/lib/harness/acp/background-work.test.ts +262 -0
  146. package/src/server/lib/harness/acp/background-work.ts +320 -0
  147. package/src/server/lib/harness/acp/calls.ts +15 -1
  148. package/src/server/lib/harness/acp/client-capabilities.test.ts +55 -0
  149. package/src/server/lib/harness/acp/client-capabilities.ts +61 -0
  150. package/src/server/lib/harness/acp/client-fs.test.ts +135 -0
  151. package/src/server/lib/harness/acp/client-fs.ts +131 -0
  152. package/src/server/lib/harness/acp/client-initialize.test.ts +70 -0
  153. package/src/server/lib/harness/acp/client-initialize.ts +84 -0
  154. package/src/server/lib/harness/acp/client.ts +33 -23
  155. package/src/server/lib/harness/acp/commands.test.ts +5 -5
  156. package/src/server/lib/harness/acp/commands.ts +14 -2
  157. package/src/server/lib/harness/acp/frames-timing.test.ts +68 -0
  158. package/src/server/lib/harness/acp/frames-v2.test.ts +85 -0
  159. package/src/server/lib/harness/acp/frames.ts +71 -158
  160. package/src/server/lib/harness/acp/gateway-env.test.ts +64 -0
  161. package/src/server/lib/harness/acp/gateway-env.ts +70 -0
  162. package/src/server/lib/harness/acp/mapper.test.ts +40 -0
  163. package/src/server/lib/harness/acp/mapper.ts +12 -0
  164. package/src/server/lib/harness/acp/permissions.ts +6 -0
  165. package/src/server/lib/harness/acp/prompt.test.ts +20 -0
  166. package/src/server/lib/harness/acp/prompt.ts +19 -3
  167. package/src/server/lib/harness/acp/protocol.ts +41 -2
  168. package/src/server/lib/harness/acp/session-background.test.ts +129 -0
  169. package/src/server/lib/harness/acp/session-exit.ts +31 -0
  170. package/src/server/lib/harness/acp/session-facts.ts +1 -1
  171. package/src/server/lib/harness/acp/session-handshake.test.ts +197 -0
  172. package/src/server/lib/harness/acp/session-handshake.ts +110 -7
  173. package/src/server/lib/harness/acp/session-idle.ts +7 -6
  174. package/src/server/lib/harness/acp/session-listeners.ts +31 -0
  175. package/src/server/lib/harness/acp/session-notifications.ts +41 -2
  176. package/src/server/lib/harness/acp/session-observers.test.ts +63 -0
  177. package/src/server/lib/harness/acp/session-permissions.test.ts +29 -0
  178. package/src/server/lib/harness/acp/session-permissions.ts +36 -0
  179. package/src/server/lib/harness/acp/session-requests.test.ts +92 -0
  180. package/src/server/lib/harness/acp/session-requests.ts +89 -0
  181. package/src/server/lib/harness/acp/session-turns.ts +28 -8
  182. package/src/server/lib/harness/acp/session-usage.ts +4 -0
  183. package/src/server/lib/harness/acp/session-web-state.ts +30 -2
  184. package/src/server/lib/harness/acp/session.test-util.ts +42 -2
  185. package/src/server/lib/harness/acp/session.ts +115 -115
  186. package/src/server/lib/harness/acp/tool-calls.ts +223 -0
  187. package/src/server/lib/harness/acp/turn.test.ts +183 -0
  188. package/src/server/lib/harness/acp/turn.ts +102 -10
  189. package/src/server/lib/harness/acp/v2.test.ts +144 -0
  190. package/src/server/lib/harness/acp/v2.ts +220 -0
  191. package/src/server/lib/harness/acp/verbs.ts +58 -8
  192. package/src/server/lib/harness/launch.test.ts +25 -0
  193. package/src/server/lib/harness/launch.ts +24 -10
  194. package/src/server/lib/harness/session.ts +3 -0
  195. package/src/server/lib/harness/spawn.server.ts +15 -2
  196. package/src/server/lib/harness/update-job-store.test.ts +151 -0
  197. package/src/server/lib/harness/update-job-store.ts +115 -0
  198. package/src/server/lib/harness/update-job.server.ts +94 -0
  199. package/src/server/lib/harness/update-queue.server.ts +292 -0
  200. package/src/server/lib/harness/update-queue.test.ts +265 -0
  201. package/src/server/lib/harness/update-spawn.server.ts +96 -0
  202. package/src/server/lib/harness/update-worker.test.ts +153 -0
  203. package/src/server/lib/harness/update-worker.ts +202 -0
  204. package/src/server/lib/lifecycle/after-listen.ts +9 -0
  205. package/src/server/lib/lifecycle/paths.ts +28 -0
  206. package/src/server/lib/omp/rpc/manager.ts +5 -5
  207. package/src/server/lib/omp/rpc/prewarm-pool.ts +12 -3
  208. package/src/server/lib/omp/rpc/run-settle.server.ts +10 -1
  209. package/src/server/lib/omp/rpc/session-registry.ts +14 -2
  210. package/src/server/lib/omp/rpc/subagent-liveness.ts +5 -5
  211. package/src/server/lib/omp/rpc/terminal-settle.ts +58 -6
  212. package/src/server/lib/omp/session/delete-flow.server.ts +48 -0
  213. package/src/server/lib/omp/session/delete.server.ts +5 -0
  214. package/src/server/lib/omp/session/rewind-file.ts +39 -21
  215. package/src/server/lib/omp/session/sidebar-data.server.ts +16 -18
  216. package/src/server/lib/omp/session/transcript-copy.ts +123 -0
  217. package/src/server/lib/sessions/agent-token.server.test.ts +64 -0
  218. package/src/server/lib/sessions/agent-token.server.ts +134 -0
  219. package/src/server/lib/sessions/answers.server.test.ts +33 -0
  220. package/src/server/lib/sessions/answers.server.ts +37 -0
  221. package/src/server/lib/sessions/dispatch.server.test.ts +143 -0
  222. package/src/server/lib/sessions/dispatch.server.ts +128 -0
  223. package/src/server/lib/sessions/fork.server.test.ts +277 -0
  224. package/src/server/lib/sessions/fork.server.ts +329 -0
  225. package/src/server/lib/sessions/lifecycle.server.test.ts +75 -0
  226. package/src/server/lib/sessions/lifecycle.server.ts +71 -0
  227. package/src/server/lib/sessions/notify.server.test.ts +112 -0
  228. package/src/server/lib/sessions/notify.server.ts +212 -0
  229. package/src/server/lib/sessions/relation-types.ts +76 -0
  230. package/src/server/lib/sessions/relations.server.test.ts +207 -0
  231. package/src/server/lib/sessions/relations.server.ts +337 -0
  232. package/src/server/lib/sessions/resolve.server.ts +106 -0
  233. package/src/server/lib/sessions/schema.server.ts +82 -0
  234. package/src/server/lib/sessions/sidebar-relations.server.test.ts +61 -0
  235. package/src/server/lib/sessions/sidebar-relations.server.ts +47 -0
  236. package/src/server/lib/sessions/spawn.server.test.ts +237 -0
  237. package/src/server/lib/sessions/spawn.server.ts +335 -0
  238. package/src/server/lib/terminal/attach-replay.test.ts +2 -2
  239. package/src/server/lib/terminal/output.test.ts +2 -2
  240. package/src/server/lib/terminal/output.ts +1 -1
  241. package/src/server/lib/terminal/resize.test.ts +99 -0
  242. package/src/server/lib/terminal/runtime.server.ts +26 -6
  243. package/src/server/lib/terminal/send-result.test.ts +18 -1
  244. package/src/server/lib/terminal/send-result.ts +26 -2
  245. package/src/server/lib/terminal/session.server.ts +6 -6
  246. package/src/server/lib/usage/new-api.test.ts +92 -0
  247. package/src/server/lib/usage/new-api.ts +131 -0
  248. package/src/server/lib/usage/provider-endpoint.test.ts +106 -0
  249. package/src/server/lib/usage/provider-key.ts +33 -0
  250. package/src/server/lib/usage/providers.server.ts +10 -3
  251. package/src/server/lib/usage/vendor-balance.server.ts +4 -53
  252. package/src/server/lib/usage/vendor-http.ts +41 -0
  253. package/src/server/lib/usage/window.ts +55 -0
  254. package/src/server/routes/agent/command.ts +14 -1
  255. package/src/server/routes/agent/harness-command.ts +12 -5
  256. package/src/server/routes/agent/new.ts +15 -0
  257. package/src/server/routes/chat/stream.ts +7 -2
  258. package/src/server/routes/harness/add-provider.test.ts +9 -1
  259. package/src/server/routes/harness/import-action.ts +4 -0
  260. package/src/server/routes/harness/import.test.ts +1 -1
  261. package/src/server/routes/harness/index.ts +5 -1
  262. package/src/server/routes/harness/update-status.ts +32 -0
  263. package/src/server/routes/harness/update.test.ts +156 -0
  264. package/src/server/routes/harness/update.ts +64 -147
  265. package/src/server/routes/sessions/answer.ts +24 -0
  266. package/src/server/routes/sessions/batch-delete.ts +11 -5
  267. package/src/server/routes/sessions/body-readers.ts +43 -0
  268. package/src/server/routes/sessions/delete.ts +4 -2
  269. package/src/server/routes/sessions/fork.ts +89 -0
  270. package/src/server/routes/sessions/index.ts +14 -0
  271. package/src/server/routes/sessions/relations.ts +85 -0
  272. package/src/server/routes/sessions/routes.test.ts +1 -2
  273. package/src/server/routes/sessions/session.ts +23 -0
  274. package/src/server/routes/sessions/spawn.ts +137 -0
  275. package/src/server/routes/terminal/ws.ts +3 -3
  276. package/src/shared/lib/chat/composer/client.ts +31 -2
  277. package/src/shared/lib/chat/composer/delegation.test.ts +93 -0
  278. package/src/shared/lib/chat/composer/delegation.ts +206 -0
  279. package/src/shared/lib/chat/notice-text.ts +1 -1
  280. package/src/shared/lib/chat/omp/agent-events.ts +11 -0
  281. package/src/shared/lib/chat/omp/session-modes-signal.test.ts +41 -0
  282. package/src/shared/lib/chat/tool/summary-wait.test.ts +11 -0
  283. package/src/shared/lib/code/ansi.ts +1 -1
  284. package/src/shared/lib/fonts/nerd-symbols.css +4 -3
  285. package/src/shared/lib/fonts/nerd-symbols.test.ts +9 -9
  286. package/src/shared/lib/harness/mode-signal.ts +20 -0
  287. package/src/shared/lib/harness/provider-facts.test.ts +27 -0
  288. package/src/shared/lib/harness/providers.ts +35 -1
  289. package/src/shared/lib/harness/session-modes.ts +24 -0
  290. package/src/shared/lib/harness/update-job.ts +80 -0
  291. package/src/shared/lib/harness/update-plan.test.ts +21 -6
  292. package/src/shared/lib/harness/update-plan.ts +12 -4
  293. package/src/shared/lib/icons/tint-hues.generated.ts +34 -34
  294. package/src/shared/lib/notifications/outcomes.test.ts +96 -0
  295. package/src/shared/lib/notifications/outcomes.ts +64 -0
  296. package/src/shared/lib/notifications/settings.test.ts +49 -0
  297. package/src/shared/lib/notifications/settings.ts +34 -0
  298. package/src/shared/lib/omp/session/default-title.ts +5 -4
  299. package/src/shared/lib/omp/session/prewarm-misc.test.ts +3 -2
  300. package/src/shared/lib/omp/session/schema-migrations.ts +4 -0
  301. package/src/shared/lib/omp/session/stream-state.server.test.ts +19 -0
  302. package/src/shared/lib/omp/session/stream-state.server.ts +24 -4
  303. package/src/shared/lib/omp/session/wait-idle.test.ts +11 -0
  304. package/src/shared/lib/omp/session/wait-idle.ts +12 -2
  305. package/src/shared/lib/settings/defaults.ts +3 -0
  306. package/src/shared/lib/theme/catalog.test.ts +13 -9
  307. package/src/shared/lib/theme/color.test.ts +2 -2
  308. package/src/shared/lib/theme/color.ts +4 -4
  309. package/src/shared/lib/theme/theme.test.ts +1 -1
  310. package/src/shared/lib/workspace/terminal/input.test.ts +27 -0
  311. package/src/shared/lib/workspace/terminal/input.ts +33 -0
  312. package/src/shared/lib/workspace/terminal/keys.test.ts +1 -1
  313. package/src/shared/lib/workspace/terminal/keys.ts +7 -7
  314. package/src/shared/types/chat.ts +1 -1
  315. package/src/shared/types/harness-update.ts +89 -0
  316. package/src/shared/types/omp/agent.ts +19 -2
  317. package/src/shared/types/realtime.ts +2 -0
  318. package/src/shared/types/settings/state.ts +10 -0
  319. package/src/shared/types/workspace.ts +8 -0
  320. package/src/test-support/fake-omp-fork.ts +16 -2
  321. package/src/test-support/harness-table.test-util.ts +31 -1
  322. package/dist/client/static/js/index-z3w7n85q.css +0 -1
  323. package/src/client/components/common/subagent-list/index.tsx +0 -165
  324. package/src/client/components/workspace/terminal-panel/webgl.test.ts +0 -75
  325. package/src/client/components/workspace/terminal-panel/webgl.ts +0 -108
@@ -0,0 +1,128 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Wake a session that is not running, so a queued system notice can be
8
+ * delivered to it.
9
+ *
10
+ * The existing queue dispatcher assumes a LIVE session (`QueueDeliveryHost`):
11
+ * `waiting/runtime.server.ts` is the other cold path, and it only knows how to
12
+ * spawn a fresh omp child. A parent that finished an hour ago is neither live
13
+ * nor fresh, so the notice would sit in `queued_messages` until the user opened
14
+ * the tab — which defeats the point of a manager session.
15
+ *
16
+ * The deps are injectable so the branch logic (file → RPC, recorded ACP →
17
+ * `session/load`, unresolvable → null) is testable without spawning an agent.
18
+ */
19
+
20
+ import { getLiveSession, startRpcSession } from '@/server/lib/omp/rpc/session-registry';
21
+ import { findSessionFileById } from '@/server/lib/omp/session/locator';
22
+ import { startAcpSession } from '@/server/lib/harness/spawn.server';
23
+ import { repointHarnessSession } from '@/server/lib/harness/session-store.server';
24
+ import { loadPersistedAccessMode } from '@/shared/lib/omp/config/access-mode.server';
25
+ import { loadStreamStates } from '@/shared/lib/omp/session/stream-state.server';
26
+ import { emitRealtimeSignal } from '@/server/lib/realtime/signals.server';
27
+ import type { QueueDeliveryHost } from '@/server/lib/queue/delivery.server';
28
+ import { resolveSessionRef } from '@/server/lib/sessions/resolve.server';
29
+ import { mintAgentEnvironment, rememberAgentToken } from '@/server/lib/sessions/agent-token.server';
30
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
31
+
32
+ export interface DispatchDeps {
33
+ findFile(sessionId: string): Promise<string | undefined>;
34
+ startOmp(sessionId: string, file: string, cwd: string): Promise<QueueDeliveryHost>;
35
+ startAcp(
36
+ sessionId: string,
37
+ harness: HarnessId,
38
+ cwd: string,
39
+ agentSessionId: string,
40
+ ): Promise<QueueDeliveryHost>;
41
+ }
42
+
43
+ async function startOmp(sessionId: string, file: string, cwd: string): Promise<QueueDeliveryHost> {
44
+ const accessMode = await loadPersistedAccessMode();
45
+ const states = await loadStreamStates();
46
+ const model = states[sessionId]?.model ?? null;
47
+ const { token, env } = mintAgentEnvironment();
48
+ const { session } = await startRpcSession(
49
+ sessionId,
50
+ file,
51
+ cwd,
52
+ cwd,
53
+ accessMode,
54
+ env,
55
+ model ?? undefined,
56
+ );
57
+ await rememberAgentToken(sessionId, token).catch((cause: unknown) => {
58
+ console.error(`[sessions] could not record the agent token for ${sessionId}:`, cause);
59
+ });
60
+ return session;
61
+ }
62
+
63
+ async function startAcp(
64
+ sessionId: string,
65
+ harness: HarnessId,
66
+ cwd: string,
67
+ agentSessionId: string,
68
+ ): Promise<QueueDeliveryHost> {
69
+ const accessMode = await loadPersistedAccessMode();
70
+ const { token, env } = mintAgentEnvironment();
71
+ const { session, realSessionId } = await startAcpSession({
72
+ harness,
73
+ sessionId,
74
+ resumeAgentSessionId: agentSessionId || sessionId,
75
+ cwd,
76
+ accessMode,
77
+ env,
78
+ });
79
+ await rememberAgentToken(sessionId, token).catch((cause: unknown) => {
80
+ console.error(`[sessions] could not record the agent token for ${sessionId}:`, cause);
81
+ });
82
+ // A load that forks answers a new agent id. The session keeps ITS id (the
83
+ // URL and the relation name it), and the record adopts the agent's — the same
84
+ // rule `resumeRecordedHarnessSession` applies.
85
+ if (realSessionId !== sessionId) {
86
+ await repointHarnessSession(sessionId, realSessionId).catch(() => {});
87
+ emitRealtimeSignal('sidebar-structure');
88
+ }
89
+ return session;
90
+ }
91
+
92
+ const defaultDeps: DispatchDeps = {
93
+ findFile: findSessionFileById,
94
+ startOmp,
95
+ startAcp,
96
+ };
97
+
98
+ /**
99
+ * A live session for this id, resuming it when necessary.
100
+ *
101
+ * File-backed sessions resume over RPC even when their recorded harness is
102
+ * `omp-acp`: omp writes the transcript, and `session/load` on omp forks — which
103
+ * would create a second id for the same chat. ACP-only sessions use
104
+ * `session/load`. Anything unresolvable returns null and the caller reports it.
105
+ */
106
+ export async function ensureSessionLive(
107
+ sessionId: string,
108
+ deps: DispatchDeps = defaultDeps,
109
+ ): Promise<QueueDeliveryHost | null> {
110
+ const live = getLiveSession(sessionId);
111
+ if (live?.isAlive()) return live;
112
+
113
+ const ref = await resolveSessionRef(sessionId);
114
+ if (!ref.cwd) return null;
115
+
116
+ try {
117
+ const file = await deps.findFile(sessionId);
118
+ if (file) return await deps.startOmp(sessionId, file, ref.cwd);
119
+ if (!ref.harness || ref.harness === 'omp-rpc') return null;
120
+ return await deps.startAcp(sessionId, ref.harness, ref.cwd, ref.agentSessionId);
121
+ } catch (error) {
122
+ console.error(
123
+ `[sessions] could not resume ${sessionId}:`,
124
+ error instanceof Error ? error.message : error,
125
+ );
126
+ return null;
127
+ }
128
+ }
@@ -0,0 +1,277 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Forking: the file surgery, the anchor rules, and the capability refusal.
8
+ *
9
+ * A real omp child is replaced by a fake start function; everything that
10
+ * matters here is the transcript Kabmo writes and the relation it records.
11
+ */
12
+
13
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
14
+ import { mkdtempSync } from 'node:fs';
15
+ import { readFile, readdir, rm, mkdir } from 'node:fs/promises';
16
+ import { tmpdir } from 'node:os';
17
+ import { join } from 'node:path';
18
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
19
+ import { getDb } from '@/server/db.server';
20
+ import { ensureSessionRelationsSchema } from '@/server/lib/sessions/schema.server';
21
+ import { saveHarnessSession } from '@/server/lib/harness/session-store.server';
22
+ import { getSessionRelation } from '@/server/lib/sessions/relations.server';
23
+ import { forkSession, type ForkSessionDeps, type ForkedSession } from '@/server/lib/sessions/fork.server';
24
+ import { buildTitleLine } from '@/server/lib/omp/session/transcript-copy';
25
+ import { clearSessionFileCaches } from '@/server/lib/omp/session/files';
26
+
27
+ let sessionsRoot = '';
28
+ let projectDir = '';
29
+ let agentRoot = '';
30
+ let savedAgentDir: string | undefined;
31
+ const timestamp = '2026-11-09T10:00:00.000Z';
32
+
33
+ beforeEach(async () => {
34
+ await isolateDb();
35
+ await ensureSessionRelationsSchema(await getDb());
36
+ savedAgentDir = Bun.env.PI_CODING_AGENT_DIR;
37
+ agentRoot = mkdtempSync(join(tmpdir(), 'kabmo-fork-agent-'));
38
+ sessionsRoot = join(agentRoot, 'sessions');
39
+ projectDir = join(sessionsRoot, 'project');
40
+ await mkdir(projectDir, { recursive: true });
41
+ Bun.env.PI_CODING_AGENT_DIR = agentRoot;
42
+ clearSessionFileCaches();
43
+ });
44
+
45
+ afterEach(async () => {
46
+ if (savedAgentDir === undefined) delete Bun.env.PI_CODING_AGENT_DIR;
47
+ else Bun.env.PI_CODING_AGENT_DIR = savedAgentDir;
48
+ clearSessionFileCaches();
49
+ await rm(agentRoot, { recursive: true, force: true });
50
+ await releaseDb();
51
+ });
52
+
53
+ const sourceLines = [
54
+ buildTitleLine('source chat', 'user', timestamp),
55
+ JSON.stringify({ type: 'session', id: 'src', cwd: '/tmp/project', timestamp }),
56
+ JSON.stringify({ type: 'message', id: 'u1', message: { role: 'user', content: [{ type: 'text', text: 'first' }] } }),
57
+ JSON.stringify({ type: 'message', id: 'a1', message: { role: 'assistant', content: [{ type: 'text', text: 'answer one' }] } }),
58
+ JSON.stringify({ type: 'message', id: 'u2', message: { role: 'user', content: [{ type: 'text', text: 'second' }] } }),
59
+ JSON.stringify({ type: 'message', id: 'a2', message: { role: 'assistant', content: [{ type: 'text', text: 'answer two' }] } }),
60
+ ];
61
+
62
+ async function writeSource(): Promise<string> {
63
+ const file = join(projectDir, `${timestamp.replace(/[:.]/g, '-')}_src.jsonl`);
64
+ await Bun.write(file, `${sourceLines.join('\n')}\n`);
65
+ clearSessionFileCaches();
66
+ return file;
67
+ }
68
+
69
+ function fakeForked(sessionId: string): ForkedSession & { sent: unknown[] } {
70
+ const state = {
71
+ sessionId,
72
+ sent: [] as unknown[],
73
+ async send(command: Record<string, unknown>) {
74
+ state.sent.push(command);
75
+ return { agentInvoked: true };
76
+ },
77
+ async destroyAndWait() {},
78
+ };
79
+ return state;
80
+ }
81
+
82
+ function fakeDeps(
83
+ sessionId: string,
84
+ options: { forkSupported?: boolean } = {},
85
+ ): ForkSessionDeps & { rpcCalls: unknown[]; acpCalls: unknown[] } {
86
+ const rpcCalls: unknown[] = [];
87
+ const acpCalls: unknown[] = [];
88
+ return {
89
+ rpcCalls,
90
+ acpCalls,
91
+ async startRpc(id, file, cwd) {
92
+ rpcCalls.push({ id, file, cwd });
93
+ return { session: fakeForked(id), realSessionId: id };
94
+ },
95
+ async startAcp(request) {
96
+ acpCalls.push(request);
97
+ return { session: fakeForked(sessionId), realSessionId: sessionId };
98
+ },
99
+ async probeForkSupported() {
100
+ return options.forkSupported ?? false;
101
+ },
102
+ };
103
+ }
104
+
105
+ /** The fork's file: the one file in the directory that is not the source. */
106
+ async function forkFile(sourceFile: string): Promise<{ path: string; lines: string[] }> {
107
+ const files = (await readdir(projectDir)).filter((name) => name.endsWith('.jsonl') && join(projectDir, name) !== sourceFile);
108
+ expect(files).toHaveLength(1);
109
+ const path = join(projectDir, files[0]!);
110
+ const lines = (await readFile(path, 'utf8')).trimEnd().split('\n');
111
+ return { path, lines };
112
+ }
113
+
114
+ describe('forkSession (omp)', () => {
115
+ test('tip fork copies every turn under a new header', async () => {
116
+ const sourceFile = await writeSource();
117
+ const deps = fakeDeps('ignored');
118
+ const result = await forkSession({ sourceSessionId: 'src' }, deps);
119
+
120
+ expect(result.originKind).toBe('fork');
121
+ expect(await getSessionRelation(result.sessionId)).toMatchObject({
122
+ sourceSessionId: 'src',
123
+ originKind: 'fork',
124
+ parentSessionId: null,
125
+ });
126
+ const { path, lines } = await forkFile(sourceFile);
127
+ expect(deps.rpcCalls).toHaveLength(1);
128
+ expect((deps.rpcCalls[0] as { file: string }).file).toBe(path);
129
+ const header = JSON.parse(lines[1]!) as Record<string, unknown>;
130
+ expect(header).toMatchObject({ id: result.sessionId, parentSession: sourceFile });
131
+ expect(lines.some((line) => line.includes('"text":"answer two"'))).toBe(true);
132
+ // The source is untouched.
133
+ expect(await readFile(sourceFile, 'utf8')).toBe(`${sourceLines.join('\n')}\n`);
134
+ });
135
+
136
+ test('an anchor on a user message branches before that turn', async () => {
137
+ const sourceFile = await writeSource();
138
+ await forkSession({ sourceSessionId: 'src', anchorEntryId: 'u2' }, fakeDeps('ignored'));
139
+ const { lines } = await forkFile(sourceFile);
140
+ expect(lines.some((line) => line.includes('"id":"u2"'))).toBe(false);
141
+ expect(lines.some((line) => line.includes('"id":"a1"'))).toBe(true);
142
+ });
143
+
144
+ test('an anchor the transcript does not carry is refused, not treated as tip', async () => {
145
+ await writeSource();
146
+ await expect(
147
+ forkSession({ sourceSessionId: 'src', anchorEntryId: 'overlay-only' }, fakeDeps('never')),
148
+ ).rejects.toMatchObject({ code: 'anchor_not_found' });
149
+ });
150
+
151
+ test('an anchor on an assistant message keeps that turn and drops later ones', async () => {
152
+ const sourceFile = await writeSource();
153
+ await forkSession({ sourceSessionId: 'src', anchorEntryId: 'a1' }, fakeDeps('ignored'));
154
+ const { lines } = await forkFile(sourceFile);
155
+ expect(lines.some((line) => line.includes('"id":"a1"'))).toBe(true);
156
+ expect(lines.some((line) => line.includes('"id":"u2"'))).toBe(false);
157
+ });
158
+
159
+ test('an RPC fork applies the composer picks before its first prompt', async () => {
160
+ await writeSource();
161
+ const forked = fakeForked('child');
162
+ let capturedMode: string | undefined;
163
+ const deps: ForkSessionDeps = {
164
+ async startRpc(id, _file, _cwd, accessMode) {
165
+ capturedMode = accessMode;
166
+ return { session: forked, realSessionId: id };
167
+ },
168
+ async startAcp() {
169
+ throw new Error('not used');
170
+ },
171
+ async probeForkSupported() {
172
+ return false;
173
+ },
174
+ };
175
+
176
+ await forkSession(
177
+ {
178
+ sourceSessionId: 'src',
179
+ prompt: 'try another angle',
180
+ model: { provider: 'acme', modelId: 'big' },
181
+ thinkingLevel: 'high',
182
+ accessMode: 'yolo',
183
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
184
+ },
185
+ deps,
186
+ );
187
+
188
+ expect(capturedMode).toBe('yolo');
189
+ expect(forked.sent).toEqual([
190
+ { type: 'set_model', provider: 'acme', modelId: 'big' },
191
+ { type: 'set_thinking_level', level: 'high' },
192
+ {
193
+ type: 'prompt',
194
+ message: 'try another angle',
195
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
196
+ },
197
+ ]);
198
+ });
199
+ });
200
+
201
+ describe('forkSession (ACP)', () => {
202
+ test('a recorded ACP session forks through session/fork', async () => {
203
+ await saveHarnessSession({
204
+ sessionId: 'acp-source',
205
+ harness: 'claude',
206
+ agentSessionId: 'agent-1',
207
+ cwd: '/tmp/project',
208
+ });
209
+ const deps = fakeDeps('acp-fork', { forkSupported: true });
210
+ const result = await forkSession({ sourceSessionId: 'acp-source' }, deps);
211
+ expect(result.sessionId).toBe('acp-fork');
212
+ expect(deps.acpCalls).toEqual([
213
+ expect.objectContaining({ harness: 'claude', forkAgentSessionId: 'agent-1' }),
214
+ ]);
215
+ expect(await getSessionRelation('acp-fork')).toMatchObject({
216
+ sourceSessionId: 'acp-source',
217
+ originKind: 'fork',
218
+ });
219
+ });
220
+
221
+ test('an ACP fork receives the composer model, thinking level and access mode', async () => {
222
+ await saveHarnessSession({
223
+ sessionId: 'acp-source',
224
+ harness: 'claude',
225
+ agentSessionId: 'agent-1',
226
+ cwd: '/tmp/project',
227
+ });
228
+ const deps = fakeDeps('acp-fork', { forkSupported: true });
229
+ await forkSession(
230
+ {
231
+ sourceSessionId: 'acp-source',
232
+ model: { provider: 'claude', modelId: 'opus' },
233
+ thinkingLevel: 'high',
234
+ accessMode: 'write',
235
+ },
236
+ deps,
237
+ );
238
+ expect(deps.acpCalls).toEqual([
239
+ expect.objectContaining({
240
+ harness: 'claude',
241
+ model: { provider: 'claude', modelId: 'opus' },
242
+ thinkingLevel: 'high',
243
+ accessMode: 'write',
244
+ }),
245
+ ]);
246
+ });
247
+
248
+ test('a harness without fork support is refused before spawning', async () => {
249
+ await saveHarnessSession({
250
+ sessionId: 'acp-source',
251
+ harness: 'claude',
252
+ agentSessionId: 'agent-1',
253
+ cwd: '/tmp/project',
254
+ });
255
+ const deps = fakeDeps('never', { forkSupported: false });
256
+ await expect(forkSession({ sourceSessionId: 'acp-source' }, deps)).rejects.toMatchObject({
257
+ code: 'fork_unsupported',
258
+ });
259
+ expect(deps.acpCalls).toHaveLength(0);
260
+ });
261
+
262
+ test('a checkpoint requirement is its own refusal, not a generic failure', async () => {
263
+ await saveHarnessSession({
264
+ sessionId: 'zcode-source',
265
+ harness: 'zcode',
266
+ agentSessionId: 'agent-z',
267
+ cwd: '/tmp/project',
268
+ });
269
+ const deps = fakeDeps('never', { forkSupported: true });
270
+ deps.startAcp = async () => {
271
+ throw new Error('fork failed: No workspace checkpoint is available yet.');
272
+ };
273
+ await expect(forkSession({ sourceSessionId: 'zcode-source' }, deps)).rejects.toMatchObject({
274
+ code: 'fork_requires_checkpoint',
275
+ });
276
+ });
277
+ });