@kabmo-labs/kabmo 0.23.0 → 0.25.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 +805 -736
  3. package/dist/client/static/js/index-bc9aa4mx.css +1 -0
  4. package/dist/client/static/js/{index-ph0q59rs.js → index-ga8cbpt4.js} +1071 -1171
  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/Modal.tsx +2 -6
  13. package/src/client/components/common/code-surface/shiki.test.ts +82 -0
  14. package/src/client/components/common/code-surface/shiki.ts +28 -7
  15. package/src/client/components/common/session-actions-menu/NewChildSessionDialog.tsx +113 -0
  16. package/src/client/components/common/session-actions-menu/index.tsx +33 -2
  17. package/src/client/components/common/session-row/StatusSlot.tsx +4 -4
  18. package/src/client/components/common/session-row/index.tsx +27 -1
  19. package/src/client/components/layout/desktop-layout/WorkspacePanels.tsx +7 -1
  20. package/src/client/components/layout/desktop-layout/resizer/separator-drag.ts +3 -3
  21. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +25 -12
  22. package/src/client/components/layout/session-sidebar/ChildSessionList.tsx +66 -0
  23. package/src/client/components/layout/session-sidebar/SessionItem.tsx +28 -3
  24. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.test.tsx +20 -0
  25. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +59 -12
  26. package/src/client/components/layout/session-sidebar/about-modal/HarnessTableLog.test.tsx +94 -0
  27. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.test.tsx +130 -0
  28. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.tsx +120 -0
  29. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +47 -0
  30. package/src/client/components/layout/session-sidebar/about-modal/index.test.tsx +122 -0
  31. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +55 -46
  32. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +18 -5
  33. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +21 -4
  34. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +27 -5
  35. package/src/client/components/settings/categories/harness-settings/EnvProviderForm.tsx +31 -0
  36. package/src/client/components/settings/categories/harness-settings/provider-panel.test.tsx +49 -0
  37. package/src/client/components/workspace/chat-timeline/ChatOverlays.tsx +5 -2
  38. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +64 -70
  39. package/src/client/components/workspace/chat-timeline/ComposerDockFrame.tsx +35 -0
  40. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +135 -118
  41. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +22 -1
  42. package/src/client/components/workspace/chat-timeline/MessageList.test.ts +14 -0
  43. package/src/client/components/workspace/chat-timeline/MessageList.tsx +4 -0
  44. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +3 -0
  45. package/src/client/components/workspace/chat-timeline/chat-input/index.tsx +4 -3
  46. package/src/client/components/workspace/chat-timeline/composer-dock-frame.test.tsx +155 -0
  47. package/src/client/components/workspace/chat-timeline/index.tsx +5 -2
  48. package/src/client/components/workspace/chat-timeline/pending-harness.test.tsx +1 -1
  49. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/FrameControl.tsx +11 -20
  50. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/GroupedAsk.tsx +1 -1
  51. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/QuestionBlock.tsx +1 -1
  52. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/drafts.ts +1 -1
  53. package/src/client/components/workspace/chat-timeline/tool-renderers/ask-panel/index.tsx +2 -1
  54. package/src/client/components/workspace/file-explorer/index.test.ts +25 -0
  55. package/src/client/components/workspace/file-explorer/index.tsx +9 -3
  56. package/src/client/components/workspace/model-dropdown/harness-models.test.ts +17 -0
  57. package/src/client/components/workspace/model-dropdown/harness-models.ts +33 -18
  58. package/src/client/components/workspace/model-dropdown/index.tsx +3 -3
  59. package/src/client/components/workspace/model-dropdown/popover-metrics.ts +4 -1
  60. package/src/client/components/workspace/terminal-panel/KeyBar.tsx +10 -8
  61. package/src/client/components/workspace/terminal-panel/{RealtimeXtermView.tsx → RealtimeTerminalView.tsx} +51 -58
  62. package/src/client/components/workspace/terminal-panel/fit.test.ts +37 -0
  63. package/src/client/components/workspace/terminal-panel/fit.ts +64 -0
  64. package/src/client/components/workspace/terminal-panel/fonts.test.ts +161 -0
  65. package/src/client/components/workspace/terminal-panel/fonts.ts +164 -0
  66. package/src/client/components/workspace/terminal-panel/grid.test.ts +52 -0
  67. package/src/client/components/workspace/terminal-panel/grid.ts +118 -0
  68. package/src/client/components/workspace/terminal-panel/index.tsx +25 -21
  69. package/src/client/components/workspace/terminal-panel/mount.ts +247 -223
  70. package/src/client/components/workspace/terminal-panel/navigation.test.ts +54 -0
  71. package/src/client/components/workspace/terminal-panel/navigation.ts +47 -0
  72. package/src/client/data/settings/omp-schema.json +5 -5
  73. package/src/client/data/theme/terminal.test.ts +25 -0
  74. package/src/client/data/theme/terminal.ts +96 -79
  75. package/src/client/hooks/chat/composer/items.test.ts +12 -26
  76. package/src/client/hooks/chat/composer/pick-mapping.test.ts +42 -0
  77. package/src/client/hooks/chat/omp/prompt-send.test.ts +7 -7
  78. package/src/client/hooks/chat/omp/prompt-send.ts +26 -14
  79. package/src/client/hooks/chat/timeline/actions.ts +2 -2
  80. package/src/client/hooks/chat/timeline/ask-frames.ts +5 -4
  81. package/src/client/hooks/chat/timeline/new-chat-open.test.ts +86 -0
  82. package/src/client/hooks/chat/timeline/new-chat-open.ts +23 -5
  83. package/src/client/hooks/chat/timeline/new-chat.test.ts +32 -4
  84. package/src/client/hooks/chat/timeline/new-chat.ts +18 -6
  85. package/src/client/hooks/chat/timeline/prompt-text.test.ts +34 -1
  86. package/src/client/hooks/chat/timeline/prompt-text.ts +47 -20
  87. package/src/client/hooks/chat/timeline/rewind-actions.test.ts +24 -1
  88. package/src/client/hooks/chat/timeline/rewind-actions.ts +15 -11
  89. package/src/client/hooks/chat/timeline/run-identity.test.ts +52 -0
  90. package/src/client/hooks/chat/timeline/run-identity.ts +23 -11
  91. package/src/client/hooks/chat/timeline/send-execute.test.ts +56 -0
  92. package/src/client/hooks/chat/timeline/send-helpers.ts +30 -1
  93. package/src/client/hooks/chat/timeline/send-props.ts +5 -3
  94. package/src/client/hooks/chat/timeline/send-steer.test.ts +4 -4
  95. package/src/client/hooks/chat/timeline/send.test-util.ts +8 -2
  96. package/src/client/hooks/chat/timeline/send.test.ts +4 -4
  97. package/src/client/hooks/chat/timeline/send.ts +59 -53
  98. package/src/client/hooks/chat/timeline/session-load.test-util.ts +6 -2
  99. package/src/client/hooks/chat/timeline/session-load.test.ts +31 -0
  100. package/src/client/hooks/chat/timeline/session-load.ts +6 -14
  101. package/src/client/hooks/chat/timeline/session-shapes.ts +32 -0
  102. package/src/client/hooks/chat/timeline/use-fork-session.ts +49 -0
  103. package/src/client/hooks/models/harness-catalog.ts +114 -0
  104. package/src/client/hooks/models/provider-writes.test.ts +81 -0
  105. package/src/client/hooks/models/provider-writes.ts +10 -3
  106. package/src/client/hooks/models/use-harness-update.test.ts +193 -0
  107. package/src/client/hooks/models/use-harness-update.ts +202 -0
  108. package/src/client/hooks/models/use-harnesses-controller.ts +57 -0
  109. package/src/client/hooks/models/use-harnesses-signal.test.ts +128 -0
  110. package/src/client/hooks/models/use-harnesses.test.ts +2 -1
  111. package/src/client/hooks/models/use-harnesses.ts +48 -114
  112. package/src/client/hooks/workspace/child-expansion.ts +33 -0
  113. package/src/client/hooks/workspace/terminal/index.ts +17 -3
  114. package/src/client/hooks/workspace/terminal/socket.ts +9 -4
  115. package/src/client/lib/session-tree.test.ts +50 -0
  116. package/src/client/lib/session-tree.ts +59 -0
  117. package/src/client/tailwind.css +26 -12
  118. package/src/server/index.ts +2 -0
  119. package/src/server/lib/auth/guard.ts +10 -0
  120. package/src/server/lib/btw/session-copy.server.ts +6 -44
  121. package/src/server/lib/btw/session-copy.test.ts +2 -1
  122. package/src/server/lib/db/schema.ts +4 -0
  123. package/src/server/lib/db/seed-terminal.test.ts +1 -1
  124. package/src/server/lib/db/seed.test.ts +1 -1
  125. package/src/server/lib/harness/acp/activation.test.ts +81 -0
  126. package/src/server/lib/harness/acp/activation.ts +72 -0
  127. package/src/server/lib/harness/acp/background-work.test.ts +262 -0
  128. package/src/server/lib/harness/acp/background-work.ts +320 -0
  129. package/src/server/lib/harness/acp/client.ts +2 -2
  130. package/src/server/lib/harness/acp/frames.test.ts +50 -1
  131. package/src/server/lib/harness/acp/frames.ts +17 -5
  132. package/src/server/lib/harness/acp/gateway-env.test.ts +64 -0
  133. package/src/server/lib/harness/acp/gateway-env.ts +70 -0
  134. package/src/server/lib/harness/acp/mapper.ts +6 -4
  135. package/src/server/lib/harness/acp/prompt.test.ts +20 -0
  136. package/src/server/lib/harness/acp/prompt.ts +19 -3
  137. package/src/server/lib/harness/acp/session-background.test.ts +129 -0
  138. package/src/server/lib/harness/acp/session-config.test.ts +73 -0
  139. package/src/server/lib/harness/acp/session-config.ts +87 -6
  140. package/src/server/lib/harness/acp/session-exit.ts +31 -0
  141. package/src/server/lib/harness/acp/session-handshake.test.ts +108 -0
  142. package/src/server/lib/harness/acp/session-handshake.ts +36 -3
  143. package/src/server/lib/harness/acp/session-idle.ts +51 -0
  144. package/src/server/lib/harness/acp/session-listeners.ts +31 -0
  145. package/src/server/lib/harness/acp/session-notifications.ts +19 -3
  146. package/src/server/lib/harness/acp/session-observers.test.ts +9 -0
  147. package/src/server/lib/harness/acp/session-options.ts +33 -0
  148. package/src/server/lib/harness/acp/session-reaper.test.ts +96 -0
  149. package/src/server/lib/harness/acp/session-requests.ts +47 -0
  150. package/src/server/lib/harness/acp/session-turns.ts +20 -5
  151. package/src/server/lib/harness/acp/session.test-util.ts +54 -3
  152. package/src/server/lib/harness/acp/session.test.ts +65 -3
  153. package/src/server/lib/harness/acp/session.ts +79 -79
  154. package/src/server/lib/harness/acp/turn.test.ts +81 -0
  155. package/src/server/lib/harness/acp/turn.ts +54 -13
  156. package/src/server/lib/harness/acp/verbs.ts +12 -2
  157. package/src/server/lib/harness/auto-probe.server.test.ts +121 -0
  158. package/src/server/lib/harness/auto-probe.server.ts +178 -0
  159. package/src/server/lib/harness/config.server.test.ts +1 -1
  160. package/src/server/lib/harness/config.server.ts +1 -1
  161. package/src/server/lib/harness/launch-table.ts +195 -0
  162. package/src/server/lib/harness/launch.test.ts +37 -0
  163. package/src/server/lib/harness/launch.ts +16 -116
  164. package/src/server/lib/harness/provider-entry.ts +32 -0
  165. package/src/server/lib/harness/provider-file.server.ts +3 -0
  166. package/src/server/lib/harness/provider-sources.server.test.ts +45 -0
  167. package/src/server/lib/harness/provider-sources.server.ts +26 -2
  168. package/src/server/lib/harness/provider-write.server.ts +21 -32
  169. package/src/server/lib/harness/provider-zcode.server.test.ts +270 -0
  170. package/src/server/lib/harness/provider-zcode.server.ts +324 -0
  171. package/src/server/lib/harness/spawn.server.ts +15 -2
  172. package/src/server/lib/harness/update-job-store.test.ts +126 -0
  173. package/src/server/lib/harness/update-job-store.ts +109 -0
  174. package/src/server/lib/harness/update-job.server.ts +203 -0
  175. package/src/server/lib/harness/update-state.server.ts +15 -20
  176. package/src/server/lib/harness/update-worker.test.ts +153 -0
  177. package/src/server/lib/harness/update-worker.ts +197 -0
  178. package/src/server/lib/lifecycle/after-listen.ts +7 -0
  179. package/src/server/lib/lifecycle/paths.ts +23 -0
  180. package/src/server/lib/models/registry-refresh.server.test.ts +87 -0
  181. package/src/server/lib/models/registry-refresh.server.ts +98 -0
  182. package/src/server/lib/omp/rpc/child-config.ts +5 -4
  183. package/src/server/lib/omp/rpc/constants.test.ts +2 -1
  184. package/src/server/lib/omp/rpc/forked-resume.test.ts +14 -3
  185. package/src/server/lib/omp/rpc/manager.ts +5 -5
  186. package/src/server/lib/omp/rpc/prewarm-pool.ts +12 -3
  187. package/src/server/lib/omp/rpc/session-registry.ts +14 -2
  188. package/src/server/lib/omp/rpc/terminal-settle.ts +53 -5
  189. package/src/server/lib/omp/session/delete-flow.server.ts +62 -8
  190. package/src/server/lib/omp/session/delete.server.ts +17 -0
  191. package/src/server/lib/omp/session/rewind-file.ts +39 -21
  192. package/src/server/lib/omp/session/sidebar-data.server.ts +6 -6
  193. package/src/server/lib/omp/session/transcript-copy.ts +123 -0
  194. package/src/server/lib/sessions/agent-token.server.test.ts +64 -0
  195. package/src/server/lib/sessions/agent-token.server.ts +134 -0
  196. package/src/server/lib/sessions/answers.server.test.ts +33 -0
  197. package/src/server/lib/sessions/answers.server.ts +37 -0
  198. package/src/server/lib/sessions/dispatch.server.test.ts +143 -0
  199. package/src/server/lib/sessions/dispatch.server.ts +128 -0
  200. package/src/server/lib/sessions/fork.server.test.ts +209 -0
  201. package/src/server/lib/sessions/fork.server.ts +304 -0
  202. package/src/server/lib/sessions/lifecycle.server.test.ts +75 -0
  203. package/src/server/lib/sessions/lifecycle.server.ts +71 -0
  204. package/src/server/lib/sessions/notify.server.test.ts +112 -0
  205. package/src/server/lib/sessions/notify.server.ts +212 -0
  206. package/src/server/lib/sessions/relation-types.ts +76 -0
  207. package/src/server/lib/sessions/relations.server.test.ts +207 -0
  208. package/src/server/lib/sessions/relations.server.ts +337 -0
  209. package/src/server/lib/sessions/resolve.server.ts +106 -0
  210. package/src/server/lib/sessions/schema.server.ts +82 -0
  211. package/src/server/lib/sessions/sidebar-relations.server.test.ts +61 -0
  212. package/src/server/lib/sessions/sidebar-relations.server.ts +47 -0
  213. package/src/server/lib/sessions/spawn.server.test.ts +196 -0
  214. package/src/server/lib/sessions/spawn.server.ts +310 -0
  215. package/src/server/lib/terminal/attach-replay.test.ts +2 -2
  216. package/src/server/lib/terminal/output.test.ts +2 -2
  217. package/src/server/lib/terminal/output.ts +1 -1
  218. package/src/server/lib/terminal/resize.test.ts +99 -0
  219. package/src/server/lib/terminal/runtime.server.ts +26 -6
  220. package/src/server/lib/terminal/send-result.test.ts +18 -1
  221. package/src/server/lib/terminal/send-result.ts +26 -2
  222. package/src/server/lib/terminal/session.server.ts +6 -6
  223. package/src/server/lib/usage/new-api.test.ts +92 -0
  224. package/src/server/lib/usage/new-api.ts +131 -0
  225. package/src/server/lib/usage/provider-endpoint.test.ts +106 -0
  226. package/src/server/lib/usage/provider-key.ts +33 -0
  227. package/src/server/lib/usage/providers.server.ts +10 -3
  228. package/src/server/lib/usage/vendor-balance.server.ts +4 -53
  229. package/src/server/lib/usage/vendor-http.ts +41 -0
  230. package/src/server/lib/usage/window.ts +55 -0
  231. package/src/server/routes/agent/command.ts +14 -1
  232. package/src/server/routes/agent/harness-command.ts +6 -0
  233. package/src/server/routes/agent/new.ts +15 -0
  234. package/src/server/routes/chat/rewind.test.ts +147 -0
  235. package/src/server/routes/chat/rewind.ts +29 -7
  236. package/src/server/routes/chat/session.test.ts +165 -10
  237. package/src/server/routes/chat/session.ts +60 -7
  238. package/src/server/routes/harness/add-provider.test.ts +9 -1
  239. package/src/server/routes/harness/import-action.ts +22 -4
  240. package/src/server/routes/harness/import.test.ts +1 -1
  241. package/src/server/routes/harness/index.ts +5 -1
  242. package/src/server/routes/harness/root.ts +8 -49
  243. package/src/server/routes/harness/toggle.test.ts +20 -0
  244. package/src/server/routes/harness/update-status.ts +26 -0
  245. package/src/server/routes/harness/update.test.ts +119 -0
  246. package/src/server/routes/harness/update.ts +67 -113
  247. package/src/server/routes/harness/versions.ts +5 -1
  248. package/src/server/routes/sessions/answer.ts +24 -0
  249. package/src/server/routes/sessions/batch-delete.ts +11 -5
  250. package/src/server/routes/sessions/delete-acp.test.ts +227 -0
  251. package/src/server/routes/sessions/delete.ts +4 -2
  252. package/src/server/routes/sessions/fork.ts +74 -0
  253. package/src/server/routes/sessions/index.ts +14 -0
  254. package/src/server/routes/sessions/relations.ts +85 -0
  255. package/src/server/routes/sessions/session.ts +4 -0
  256. package/src/server/routes/sessions/spawn.ts +134 -0
  257. package/src/server/routes/settings/model-override.ts +5 -2
  258. package/src/server/routes/settings/provider-entry.ts +2 -2
  259. package/src/server/routes/settings/provider-model.ts +2 -2
  260. package/src/server/routes/settings/provider-models.ts +2 -2
  261. package/src/server/routes/settings/provider-refresh.ts +6 -4
  262. package/src/server/routes/settings/providers.ts +3 -1
  263. package/src/server/routes/settings/settings-config-routes.test.ts +10 -2
  264. package/src/server/routes/terminal/ws.ts +3 -3
  265. package/src/shared/lib/chat/ask-form/fields.ts +76 -0
  266. package/src/shared/lib/chat/ask-form/index.ts +323 -0
  267. package/src/shared/lib/chat/ask-form/tokens.ts +199 -0
  268. package/src/shared/lib/chat/ask-form/types.ts +43 -0
  269. package/src/shared/lib/chat/ask-form.test.ts +137 -0
  270. package/src/shared/lib/chat/ask-questions.test.ts +65 -1
  271. package/src/shared/lib/chat/ask-questions.ts +51 -145
  272. package/src/shared/lib/chat/ask-results.ts +198 -0
  273. package/src/shared/lib/chat/composer/client.ts +31 -2
  274. package/src/shared/lib/chat/composer/delegation.test.ts +93 -0
  275. package/src/shared/lib/chat/composer/delegation.ts +206 -0
  276. package/src/shared/lib/chat/notice-text.ts +1 -1
  277. package/src/shared/lib/chat/timeline/omp-callbacks.ts +13 -1
  278. package/src/shared/lib/chat/timeline/prompt-error.test.ts +146 -0
  279. package/src/shared/lib/chat/timeline/prompt-error.ts +88 -0
  280. package/src/shared/lib/chat/tool/summary-wait.test.ts +11 -0
  281. package/src/shared/lib/code/ansi.ts +1 -1
  282. package/src/shared/lib/fonts/nerd-symbols.css +4 -3
  283. package/src/shared/lib/fonts/nerd-symbols.test.ts +9 -9
  284. package/src/shared/lib/harness/catalog.test.ts +1 -1
  285. package/src/shared/lib/harness/config-fields.test.ts +4 -0
  286. package/src/shared/lib/harness/config-fields.ts +19 -4
  287. package/src/shared/lib/harness/dialects.test.ts +8 -0
  288. package/src/shared/lib/harness/dialects.ts +12 -0
  289. package/src/shared/lib/harness/provider-facts.test.ts +59 -8
  290. package/src/shared/lib/harness/provider-facts.ts +46 -11
  291. package/src/shared/lib/harness/providers.ts +44 -1
  292. package/src/shared/lib/harness/rewind.ts +24 -0
  293. package/src/shared/lib/harness/update-job.ts +33 -0
  294. package/src/shared/lib/harness/update-plan.test.ts +69 -4
  295. package/src/shared/lib/harness/update-plan.ts +57 -9
  296. package/src/shared/lib/harness/updates.test.ts +22 -0
  297. package/src/shared/lib/harness/updates.ts +24 -1
  298. package/src/shared/lib/models/client.ts +10 -1
  299. package/src/shared/lib/omp/dialog-methods.ts +4 -3
  300. package/src/shared/lib/omp/session/wait-idle.test.ts +11 -0
  301. package/src/shared/lib/omp/session/wait-idle.ts +12 -2
  302. package/src/shared/lib/theme/catalog.test.ts +13 -9
  303. package/src/shared/lib/theme/color.test.ts +2 -2
  304. package/src/shared/lib/theme/color.ts +4 -4
  305. package/src/shared/lib/theme/css.ts +2 -0
  306. package/src/shared/lib/theme/ink-scale.ts +21 -1
  307. package/src/shared/lib/theme/theme.test.ts +26 -10
  308. package/src/shared/lib/ui/safe-area.test.ts +28 -0
  309. package/src/shared/lib/ui/safe-area.ts +42 -0
  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 +65 -0
  316. package/src/shared/types/harness.ts +30 -4
  317. package/src/shared/types/omp/agent.ts +19 -2
  318. package/src/shared/types/workspace.ts +4 -0
  319. package/src/test-support/fake-omp-fork.ts +16 -2
  320. package/src/test-support/file-explorer-render.test-util.ts +37 -0
  321. package/src/test-support/file-explorer.test-util.ts +20 -18
  322. package/src/test-support/harness-table.test-util.ts +21 -4
  323. package/dist/client/static/js/index-jhmg4w91.css +0 -1
  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,209 @@
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
+
160
+ describe('forkSession (ACP)', () => {
161
+ test('a recorded ACP session forks through session/fork', async () => {
162
+ await saveHarnessSession({
163
+ sessionId: 'acp-source',
164
+ harness: 'claude',
165
+ agentSessionId: 'agent-1',
166
+ cwd: '/tmp/project',
167
+ });
168
+ const deps = fakeDeps('acp-fork', { forkSupported: true });
169
+ const result = await forkSession({ sourceSessionId: 'acp-source' }, deps);
170
+ expect(result.sessionId).toBe('acp-fork');
171
+ expect(deps.acpCalls).toEqual([
172
+ expect.objectContaining({ harness: 'claude', forkAgentSessionId: 'agent-1' }),
173
+ ]);
174
+ expect(await getSessionRelation('acp-fork')).toMatchObject({
175
+ sourceSessionId: 'acp-source',
176
+ originKind: 'fork',
177
+ });
178
+ });
179
+
180
+ test('a harness without fork support is refused before spawning', async () => {
181
+ await saveHarnessSession({
182
+ sessionId: 'acp-source',
183
+ harness: 'claude',
184
+ agentSessionId: 'agent-1',
185
+ cwd: '/tmp/project',
186
+ });
187
+ const deps = fakeDeps('never', { forkSupported: false });
188
+ await expect(forkSession({ sourceSessionId: 'acp-source' }, deps)).rejects.toMatchObject({
189
+ code: 'fork_unsupported',
190
+ });
191
+ expect(deps.acpCalls).toHaveLength(0);
192
+ });
193
+
194
+ test('a checkpoint requirement is its own refusal, not a generic failure', async () => {
195
+ await saveHarnessSession({
196
+ sessionId: 'zcode-source',
197
+ harness: 'zcode',
198
+ agentSessionId: 'agent-z',
199
+ cwd: '/tmp/project',
200
+ });
201
+ const deps = fakeDeps('never', { forkSupported: true });
202
+ deps.startAcp = async () => {
203
+ throw new Error('fork failed: No workspace checkpoint is available yet.');
204
+ };
205
+ await expect(forkSession({ sourceSessionId: 'zcode-source' }, deps)).rejects.toMatchObject({
206
+ code: 'fork_requires_checkpoint',
207
+ });
208
+ });
209
+ });
@@ -0,0 +1,304 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * Fork a session: a new session that starts with the source's history.
8
+ *
9
+ * The two transports answer this differently, and neither is a rewrite of the
10
+ * source:
11
+ *
12
+ * - omp: copy the transcript, cut it at the anchor's turn start, rewrite the
13
+ * header id and title, write a new `<ts>_<id>.jsonl`, then resume that file.
14
+ * The source bytes are never touched.
15
+ * - ACP: ask the agent for `session/fork`. The agent owns the history, so the
16
+ * returned session id is the child; Kabmo records the source edge and does
17
+ * not pretend to hold a local transcript.
18
+ *
19
+ * A fork is NOT a child: it writes `source_session_id` + `origin_kind`, never
20
+ * `parent_session_id`, so it stays out of the parent tree and sends no outcome
21
+ * notification. A user can reparent it afterwards.
22
+ */
23
+
24
+ import * as path from 'node:path';
25
+ import { loadPersistedAccessMode } from '@/shared/lib/omp/config/access-mode.server';
26
+ import { startRpcSession } from '@/server/lib/omp/rpc/session-registry';
27
+ import { startAcpSession } from '@/server/lib/harness/spawn.server';
28
+ import { freshProbe } from '@/server/lib/harness/probe-cache.server';
29
+ import { clearSessionFileCaches } from '@/server/lib/omp/session/files';
30
+ import { findSessionFileById } from '@/server/lib/omp/session/locator';
31
+ import { buildTruncatedBody, isRewindCutPoint } from '@/server/lib/omp/session/rewind-file';
32
+ import {
33
+ branchTranscript,
34
+ completeLines,
35
+ parseJsonObject,
36
+ transcriptTitle,
37
+ } from '@/server/lib/omp/session/transcript-copy';
38
+ import type { HarnessId } from '@/shared/lib/harness/catalog';
39
+ import type { SelectedModel } from '@/shared/types/models';
40
+ import type { ApprovalMode } from '@/shared/lib/omp/config/access-mode';
41
+ import {
42
+ createSessionRelation,
43
+ deleteSessionRelations,
44
+ listForkRelations,
45
+ } from '@/server/lib/sessions/relations.server';
46
+ import { isSessionArchived, resolveSessionRef, sessionExists } from '@/server/lib/sessions/resolve.server';
47
+ import {
48
+ agentEnvironment,
49
+ createAgentToken,
50
+ rememberAgentToken,
51
+ } from '@/server/lib/sessions/agent-token.server';
52
+
53
+ export type SessionForkErrorCode =
54
+ | 'source_not_found'
55
+ | 'source_archived'
56
+ | 'cwd_required'
57
+ | 'anchor_not_found'
58
+ | 'fork_unsupported'
59
+ | 'fork_requires_checkpoint'
60
+ | 'fork_failed';
61
+
62
+ export class SessionForkError extends Error {
63
+ constructor(
64
+ readonly code: SessionForkErrorCode,
65
+ message: string,
66
+ ) {
67
+ super(message);
68
+ this.name = 'SessionForkError';
69
+ }
70
+ }
71
+
72
+ export interface ForkedSession {
73
+ readonly sessionId: string;
74
+ send(command: Record<string, unknown>): Promise<unknown>;
75
+ destroyAndWait(): Promise<void>;
76
+ }
77
+
78
+ export interface ForkSessionDeps {
79
+ startRpc(
80
+ sessionId: string,
81
+ sessionFile: string,
82
+ cwd: string,
83
+ accessMode: ApprovalMode,
84
+ model: SelectedModel | null,
85
+ env: Record<string, string>,
86
+ ): Promise<{ session: ForkedSession; realSessionId: string }>;
87
+ startAcp(request: {
88
+ harness: HarnessId;
89
+ sessionId: string;
90
+ forkAgentSessionId: string;
91
+ cwd: string;
92
+ accessMode: ApprovalMode;
93
+ model: SelectedModel | null;
94
+ thinkingLevel: string | null;
95
+ env: Record<string, string>;
96
+ }): Promise<{ session: ForkedSession; realSessionId: string }>;
97
+ probeForkSupported(harness: HarnessId): Promise<boolean>;
98
+ }
99
+
100
+ const defaultDeps: ForkSessionDeps = {
101
+ async startRpc(sessionId, sessionFile, cwd, accessMode, model, env) {
102
+ return startRpcSession(sessionId, sessionFile, cwd, cwd, accessMode, env, model ?? undefined);
103
+ },
104
+ startAcp: (request) => startAcpSession(request),
105
+ async probeForkSupported(harness) {
106
+ const probe = await freshProbe(harness);
107
+ return probe?.capabilities.forkSession === true;
108
+ },
109
+ };
110
+
111
+ export interface ForkSessionInput {
112
+ sourceSessionId: string;
113
+ /** A message/entry id; the fork cuts at the start of its turn. Omit for tip. */
114
+ anchorEntryId?: string | null;
115
+ prompt?: string | null;
116
+ title?: string | null;
117
+ cwd?: string | null;
118
+ visibility?: 'visible' | 'hidden';
119
+ lifecycleOwnerSessionId?: string | null;
120
+ }
121
+
122
+ export interface ForkSessionResult {
123
+ sessionId: string;
124
+ sourceSessionId: string;
125
+ originKind: 'fork';
126
+ }
127
+
128
+ /**
129
+ * The record index the cut lands on.
130
+ *
131
+ * An anchor on a user turn branches BEFORE it (that is "do not send this
132
+ * message"). An anchor anywhere else — an assistant reply, a tool call —
133
+ * branches AFTER the turn that contains it, so the reply the user pointed at is
134
+ * part of the fork. No anchor (or an id the file does not carry) is the tip.
135
+ */
136
+ function cutIndexFor(records: Array<Record<string, unknown> | null>, anchorEntryId: string | null): number | null {
137
+ if (!anchorEntryId) return null;
138
+ const anchorIndex = records.findIndex((record) => record?.id === anchorEntryId);
139
+ if (anchorIndex === -1) return null;
140
+
141
+ let turnStart = -1;
142
+ for (let index = anchorIndex; index >= 0; index -= 1) {
143
+ if (isRewindCutPoint(records[index])) {
144
+ turnStart = index;
145
+ break;
146
+ }
147
+ }
148
+ if (turnStart === -1) {
149
+ const headerIndex = records.findIndex((record) => record?.type === 'session');
150
+ return headerIndex === -1 ? 0 : headerIndex + 1;
151
+ }
152
+ if (isRewindCutPoint(records[anchorIndex])) return turnStart;
153
+
154
+ const nextTurn = records.findIndex(
155
+ (record, index) => index > anchorIndex && isRewindCutPoint(record),
156
+ );
157
+ return nextTurn === -1 ? records.length : nextTurn;
158
+ }
159
+
160
+ function newBranchTitle(sourceTitle: string, sourceSessionId: string, forkCount: number): string {
161
+ return `(${forkCount}) ${sourceTitle.trim() || sourceSessionId}`;
162
+ }
163
+
164
+ async function writeBranchFile(input: {
165
+ sourceFile: string;
166
+ lines: string[];
167
+ newId: string;
168
+ timestamp: string;
169
+ title: string;
170
+ }): Promise<string> {
171
+ const body = branchTranscript({
172
+ lines: input.lines,
173
+ newId: input.newId,
174
+ timestamp: input.timestamp,
175
+ title: input.title,
176
+ parentSessionFile: input.sourceFile,
177
+ });
178
+ const fileName = `${input.timestamp.replace(/[:.]/g, '-')}_${input.newId}.jsonl`;
179
+ const target = path.join(path.dirname(input.sourceFile), fileName);
180
+ if (await Bun.file(target).exists()) {
181
+ throw new SessionForkError('fork_failed', `A session file already exists at ${fileName}`);
182
+ }
183
+ await Bun.write(target, body);
184
+ clearSessionFileCaches();
185
+ return target;
186
+ }
187
+
188
+ /** Fork a session at its tip or at an anchored turn. */
189
+ export async function forkSession(
190
+ input: ForkSessionInput,
191
+ deps: ForkSessionDeps = defaultDeps,
192
+ ): Promise<ForkSessionResult> {
193
+ if (!(await sessionExists(input.sourceSessionId))) {
194
+ throw new SessionForkError('source_not_found', 'Source session not found');
195
+ }
196
+ if (await isSessionArchived(input.sourceSessionId)) {
197
+ throw new SessionForkError('source_archived', 'Cannot fork an archived session');
198
+ }
199
+ const source = await resolveSessionRef(input.sourceSessionId);
200
+ const cwd = input.cwd || source.cwd;
201
+ if (!cwd) throw new SessionForkError('cwd_required', 'The source has no working directory');
202
+
203
+ const accessMode = await loadPersistedAccessMode();
204
+ const token = createAgentToken();
205
+ const env = agentEnvironment(token);
206
+ const forkCount = (await listForkRelations(input.sourceSessionId)).length + 1;
207
+ const sourceFile = await findSessionFileById(input.sourceSessionId);
208
+ let started: { session: ForkedSession; realSessionId: string };
209
+ let createdFile: string | null = null;
210
+
211
+ if (sourceFile) {
212
+ const raw = await Bun.file(sourceFile).text();
213
+ const lines = completeLines(raw);
214
+ const records = lines.map((line) => parseJsonObject(line));
215
+ // An id the file does not carry is usually an overlay-only row (a builtin
216
+ // command's message). Silently forking at the tip would hand back history
217
+ // the user did not point at, so it is a refusal with a code.
218
+ if (input.anchorEntryId && !records.some((record) => record?.id === input.anchorEntryId)) {
219
+ throw new SessionForkError(
220
+ 'anchor_not_found',
221
+ `The transcript has no entry ${input.anchorEntryId}`,
222
+ );
223
+ }
224
+ const cutIndex = cutIndexFor(records, input.anchorEntryId ?? null);
225
+ const kept =
226
+ cutIndex === null
227
+ ? lines
228
+ : completeLines(buildTruncatedBody(records, cutIndex).body);
229
+ const newId = crypto.randomUUID();
230
+ const timestamp = new Date().toISOString();
231
+ const title =
232
+ input.title?.trim() || newBranchTitle(transcriptTitle(lines), input.sourceSessionId, forkCount);
233
+ createdFile = await writeBranchFile({ sourceFile, lines: kept, newId, timestamp, title });
234
+ try {
235
+ started = await deps.startRpc(newId, createdFile, cwd, accessMode, null, env);
236
+ } catch (error) {
237
+ await Bun.file(createdFile).delete().catch(() => {});
238
+ throw new SessionForkError(
239
+ 'fork_failed',
240
+ error instanceof Error ? error.message : 'Could not resume the fork',
241
+ );
242
+ }
243
+ } else {
244
+ const harness = source.harness;
245
+ if (!harness || harness === 'omp-rpc') {
246
+ throw new SessionForkError('fork_unsupported', 'This session has no transcript to fork');
247
+ }
248
+ if (!(await deps.probeForkSupported(harness))) {
249
+ throw new SessionForkError('fork_unsupported', `${harness} does not support session/fork`);
250
+ }
251
+ try {
252
+ started = await deps.startAcp({
253
+ harness,
254
+ sessionId: `__new__${Bun.randomUUIDv7()}`,
255
+ forkAgentSessionId: source.agentSessionId || input.sourceSessionId,
256
+ cwd,
257
+ accessMode,
258
+ model: null,
259
+ thinkingLevel: null,
260
+ env,
261
+ });
262
+ } catch (error) {
263
+ const detail = error instanceof Error ? error.message : String(error);
264
+ // zcode advertises session/fork but refuses until the workspace has a
265
+ // checkpoint. That is a state requirement, not a missing capability, and
266
+ // the user can satisfy it by making a change first.
267
+ if (/workspace checkpoint/i.test(detail)) {
268
+ throw new SessionForkError(
269
+ 'fork_requires_checkpoint',
270
+ 'This harness needs a workspace checkpoint before it can fork: make a change in the source session first.',
271
+ );
272
+ }
273
+ throw new SessionForkError('fork_failed', detail || 'The agent refused session/fork');
274
+ }
275
+ }
276
+
277
+ try {
278
+ await rememberAgentToken(started.realSessionId, token);
279
+ await createSessionRelation({
280
+ sessionId: started.realSessionId,
281
+ sourceSessionId: input.sourceSessionId,
282
+ originKind: 'fork',
283
+ lifecycleOwnerSessionId: input.lifecycleOwnerSessionId ?? null,
284
+ visibility: input.visibility ?? 'visible',
285
+ });
286
+ if (input.prompt?.trim()) {
287
+ await started.session.send({ type: 'prompt', message: input.prompt.trim() });
288
+ }
289
+ } catch (error) {
290
+ await started.session.destroyAndWait().catch(() => {});
291
+ await deleteSessionRelations(started.realSessionId).catch(() => {});
292
+ if (createdFile) await Bun.file(createdFile).delete().catch(() => {});
293
+ throw new SessionForkError(
294
+ 'fork_failed',
295
+ error instanceof Error ? error.message : 'Could not record the fork',
296
+ );
297
+ }
298
+
299
+ return {
300
+ sessionId: started.realSessionId,
301
+ sourceSessionId: input.sourceSessionId,
302
+ originKind: 'fork',
303
+ };
304
+ }