@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
@@ -121,26 +121,15 @@ function resolveCutIndex(
121
121
  }
122
122
 
123
123
  /**
124
- * Build the truncated body: entries at/after the cut turn are dropped; header
125
- * records and everything before it survive. Returns null when the cut cannot be
126
- * resolved at all (an unknown id with no clock, or an id naming a non-turn).
124
+ * Build the body for a resolved cut index. Shared with the fork path, which
125
+ * resolves its own index (the start of the anchored turn) and must keep the
126
+ * same header-carrying rules as a rewind.
127
127
  */
128
- export function truncateSessionBody(body: string, cut: RewindCut): TruncatedSession | null {
129
- const records: Array<Record<string, unknown> | null> = body.split('\n').map((line) => {
130
- const trimmed = line.trim();
131
- if (!trimmed) return null;
132
- let parsed: unknown;
133
- try {
134
- parsed = JSON.parse(trimmed);
135
- } catch {
136
- return null;
137
- }
138
- return isRecord(parsed) ? parsed : null;
139
- });
140
-
141
- const cutIndex = resolveCutIndex(records, cut);
142
- if (cutIndex === undefined) return null;
143
-
128
+ export function buildTruncatedBody(
129
+ records: Array<Record<string, unknown> | null>,
130
+ cutIndex: number,
131
+ options: { requestedEntryId?: string; startedAt?: number } = {},
132
+ ): TruncatedSession {
144
133
  const kept = records.slice(0, cutIndex);
145
134
  const outLines = kept
146
135
  .filter((r): r is Record<string, unknown> => Boolean(r))
@@ -167,14 +156,43 @@ export function truncateSessionBody(body: string, cut: RewindCut): TruncatedSess
167
156
  // the boundary for stored rows is that same clock — not the next file turn's.
168
157
  // Using the file turn's clock kept every command row between the two alive,
169
158
  // so undoing one `/usage` left the next one standing after a reload.
170
- const resolvedByClock = cutRecord?.id !== cut.entryId;
159
+ const resolvedByClock =
160
+ options.requestedEntryId !== undefined && cutRecord?.id !== options.requestedEntryId;
171
161
  return {
172
162
  body: `${outLines.join('\n')}\n`,
173
- overlayCutClock: resolvedByClock ? cut.startedAt : (cutRecord ? recordClock(cutRecord) : undefined),
163
+ overlayCutClock: resolvedByClock
164
+ ? options.startedAt
165
+ : (cutRecord ? recordClock(cutRecord) : undefined),
174
166
  droppedEntryIds,
175
167
  };
176
168
  }
177
169
 
170
+ /**
171
+ * Build the truncated body: entries at/after the cut turn are dropped; header
172
+ * records and everything before it survive. Returns null when the cut cannot be
173
+ * resolved at all (an unknown id with no clock, or an id naming a non-turn).
174
+ */
175
+ export function truncateSessionBody(body: string, cut: RewindCut): TruncatedSession | null {
176
+ const records: Array<Record<string, unknown> | null> = body.split('\n').map((line) => {
177
+ const trimmed = line.trim();
178
+ if (!trimmed) return null;
179
+ let parsed: unknown;
180
+ try {
181
+ parsed = JSON.parse(trimmed);
182
+ } catch {
183
+ return null;
184
+ }
185
+ return isRecord(parsed) ? parsed : null;
186
+ });
187
+
188
+ const cutIndex = resolveCutIndex(records, cut);
189
+ if (cutIndex === undefined) return null;
190
+ return buildTruncatedBody(records, cutIndex, {
191
+ requestedEntryId: cut.entryId,
192
+ ...(cut.startedAt !== undefined ? { startedAt: cut.startedAt } : {}),
193
+ });
194
+ }
195
+
178
196
  /**
179
197
  * Drop the stored overlay rows the cut invalidated, and ONLY those.
180
198
  *
@@ -31,6 +31,7 @@ import { DEFAULT_HARNESS_ID, HARNESS_IDS } from '@/shared/lib/harness/catalog';
31
31
  import { knownHarness, loadAcpSessions, loadHarnessBySession } from '@/server/lib/harness/session-store.server';
32
32
  import { canonicalPath } from '@/server/lib/fs/canonical';
33
33
  import { acpRowsFor } from '@/server/lib/omp/session/acp-rows.server';
34
+ import { decorateSidebarSessions } from '@/server/lib/sessions/sidebar-relations.server';
34
35
  import type { SessionWorktreeInfo } from '@/shared/lib/workspace/worktree/types';
35
36
  import type { OmpSession } from '@/shared/types/omp/session';
36
37
 
@@ -329,9 +330,8 @@ async function buildRealFolders(folderRows: FolderRow[], archivedIds: Set<string
329
330
  // The scan's own rule is `b.modified.localeCompare(a.modified)`
330
331
  // (`groupSessionsByRoot`), so this uses the same key rather than a second
331
332
  // definition of "newest".
332
- const allSessions = [...folderSessions, ...uniqueAcp].sort((a, b) =>
333
- (b.updated_at ?? b.created_at ?? '').localeCompare(a.updated_at ?? a.created_at ?? ''),
334
- );
333
+ const allSessions = [...folderSessions, ...uniqueAcp].sort((a, b) => (b.updated_at ?? b.created_at ?? '').localeCompare(a.updated_at ?? a.created_at ?? ''));
334
+ const visibleSessions = await decorateSidebarSessions(allSessions);
335
335
  return {
336
336
  id: folder.id,
337
337
  name: folder.name,
@@ -342,9 +342,9 @@ async function buildRealFolders(folderRows: FolderRow[], archivedIds: Set<string
342
342
  accentColor: folder.accent_color || '',
343
343
  icon: folder.icon || 'default',
344
344
  customIconUrl: folder.custom_icon_url || undefined,
345
- sessions: allSessions,
346
- hasMore: allSessions.length > 7,
347
- totalSessions: allSessions.length,
345
+ sessions: visibleSessions,
346
+ hasMore: visibleSessions.length > 7,
347
+ totalSessions: visibleSessions.length,
348
348
  };
349
349
  }));
350
350
  }
@@ -0,0 +1,123 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The small pieces of omp transcript surgery shared by two features.
8
+ *
9
+ * BTW promotion turns a side-question transcript into a chat; a fork turns a
10
+ * chat into a branch. Both need the same three primitives — read whole lines
11
+ * without a torn tail, find the leaf, and rewrite the title/header pair under a
12
+ * new id — and a second copy of them is how the two drift.
13
+ *
14
+ * The file layout they rely on (verified against omp files): line 1 is a
15
+ * fixed-width title slot, line 2 is the `session` header carrying `id`, `cwd`
16
+ * and `parentSession`, and the rest are entries.
17
+ */
18
+
19
+ import { serializeTitleSlot } from '@/server/lib/omp/session/title-slot';
20
+
21
+ export function parseJsonObject(line: string): Record<string, unknown> | null {
22
+ try {
23
+ const value: unknown = JSON.parse(line);
24
+ return value && typeof value === 'object' && !Array.isArray(value)
25
+ ? (value as Record<string, unknown>)
26
+ : null;
27
+ } catch {
28
+ return null;
29
+ }
30
+ }
31
+
32
+ /**
33
+ * The file's lines, minus a torn tail.
34
+ *
35
+ * A snapshot taken while the writer is mid-append can end in a partial line;
36
+ * keeping it would make a resumed child fail to load the transcript.
37
+ */
38
+ export function completeLines(text: string): string[] {
39
+ const lines = text.split('\n');
40
+ if (lines[lines.length - 1] === '') lines.pop();
41
+ const last = lines[lines.length - 1];
42
+ if (last !== undefined && parseJsonObject(last) === null) lines.pop();
43
+ return lines;
44
+ }
45
+
46
+ /** The transcript's leaf: the id of its last entry. */
47
+ export function lastEntryId(lines: string[]): string | null {
48
+ for (let index = lines.length - 1; index >= 0; index -= 1) {
49
+ const record = parseJsonObject(lines[index]);
50
+ if (record && typeof record.id === 'string') return record.id;
51
+ }
52
+ return null;
53
+ }
54
+
55
+ /** The title slot line, padded to the fixed slot omp rewrites in place, with
56
+ * the trailing newline removed (callers join the lines themselves). */
57
+ export function buildTitleLine(title: string, source: string, updatedAt: string): string {
58
+ const line = serializeTitleSlot({
59
+ title,
60
+ source: source === 'auto' ? 'auto' : 'user',
61
+ updatedAt,
62
+ });
63
+ return line.endsWith('\n') ? line.slice(0, -1) : line;
64
+ }
65
+
66
+ /** The chat's own title, from the title slot or the header. */
67
+ export function transcriptTitle(lines: string[]): string {
68
+ for (const line of lines) {
69
+ const record = parseJsonObject(line);
70
+ if (!record) continue;
71
+ if (record.type === 'title' && typeof record.title === 'string') return record.title;
72
+ if (record.type === 'session' && typeof record.title === 'string') return record.title;
73
+ if (record.type === 'session') return '';
74
+ }
75
+ return '';
76
+ }
77
+
78
+ export interface BranchTranscriptInput {
79
+ lines: string[];
80
+ newId: string;
81
+ timestamp: string;
82
+ title: string;
83
+ /** Absolute path of the file the branch came from, as omp records it. */
84
+ parentSessionFile: string;
85
+ }
86
+
87
+ /**
88
+ * Rewrite a source transcript as a branch under a new identity.
89
+ *
90
+ * The title slot moves to line 1 (dropping the source's slot), and the header
91
+ * gets the new id, the new timestamp, the branch title and the source path.
92
+ * Every other record is copied verbatim — including model/thinking changes,
93
+ * which are what make the resumed child continue with the same selections.
94
+ */
95
+ export function branchTranscript(input: BranchTranscriptInput): string {
96
+ const body: string[] = [];
97
+ let titleDropped = false;
98
+ let headerWritten = false;
99
+ for (const line of input.lines) {
100
+ const record = parseJsonObject(line);
101
+ if (record?.type === 'title' && !titleDropped) {
102
+ titleDropped = true;
103
+ continue;
104
+ }
105
+ if (record?.type === 'session' && !headerWritten) {
106
+ headerWritten = true;
107
+ body.push(
108
+ JSON.stringify({
109
+ ...record,
110
+ id: input.newId,
111
+ timestamp: input.timestamp,
112
+ title: input.title,
113
+ titleSource: 'user',
114
+ parentSession: input.parentSessionFile,
115
+ }),
116
+ );
117
+ continue;
118
+ }
119
+ body.push(line);
120
+ }
121
+ if (!headerWritten) throw new Error('Transcript has no session header');
122
+ return `${[buildTitleLine(input.title, 'user', input.timestamp), ...body].join('\n')}\n`;
123
+ }
@@ -0,0 +1,64 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
7
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
8
+ import { getDb } from '@/server/db.server';
9
+ import { ensureSessionRelationsSchema } from '@/server/lib/sessions/schema.server';
10
+ import {
11
+ agentTokenScopeForPath,
12
+ createAgentToken,
13
+ hashAgentToken,
14
+ initAgentTokens,
15
+ rememberAgentToken,
16
+ revokeAgentToken,
17
+ verifyAgentToken,
18
+ } from '@/server/lib/sessions/agent-token.server';
19
+
20
+ beforeEach(async () => {
21
+ await isolateDb();
22
+ await ensureSessionRelationsSchema(await getDb());
23
+ globalThis.__kabmoAgentTokens = undefined;
24
+ });
25
+
26
+ afterEach(async () => {
27
+ globalThis.__kabmoAgentTokens = undefined;
28
+ await releaseDb();
29
+ });
30
+
31
+ describe('agent tokens', () => {
32
+ test('a remembered token verifies and can be revoked', async () => {
33
+ const token = createAgentToken();
34
+ await rememberAgentToken('s1', token);
35
+ expect(verifyAgentToken(token)).toBe('s1');
36
+ expect(verifyAgentToken('other')).toBeNull();
37
+
38
+ await revokeAgentToken('s1');
39
+ expect(verifyAgentToken(token)).toBeNull();
40
+ });
41
+
42
+ test('the cache is rebuilt from the table after a restart', async () => {
43
+ const token = createAgentToken();
44
+ await rememberAgentToken('s1', token);
45
+ globalThis.__kabmoAgentTokens = undefined;
46
+ await initAgentTokens();
47
+ expect(verifyAgentToken(token)).toBe('s1');
48
+ // Only the hash is stored.
49
+ const rows = (await (await getDb()).all('SELECT token_hash FROM session_agent_tokens')) as {
50
+ token_hash: string;
51
+ }[];
52
+ expect(rows[0]?.token_hash).toBe(hashAgentToken(token));
53
+ });
54
+
55
+ test('the path scope names the session it may touch', () => {
56
+ expect(agentTokenScopeForPath('/api/sessions/spawn')).toBe('any');
57
+ expect(agentTokenScopeForPath('/api/agent/s1')).toBe('s1');
58
+ expect(agentTokenScopeForPath('/api/chat/s1')).toBe('s1');
59
+ expect(agentTokenScopeForPath('/api/sessions/s1/fork')).toBe('s1');
60
+ expect(agentTokenScopeForPath('/api/sessions/s1/relations')).toBe('s1');
61
+ expect(agentTokenScopeForPath('/api/sessions/s1/archive')).toBeNull();
62
+ expect(agentTokenScopeForPath('/api/settings')).toBeNull();
63
+ });
64
+ });
@@ -0,0 +1,134 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The credential an agent uses to call back into Kabmo.
8
+ *
9
+ * A browser has a cookie; a subprocess does not. Every spawned session gets one
10
+ * random token in its environment, and the CLI presents it as a bearer token.
11
+ * Only the SHA-256 hash is stored, so the database cannot be replayed as a
12
+ * credential.
13
+ *
14
+ * The gate is synchronous and runs on every request, so verified hashes are
15
+ * mirrored in memory: `initAgentTokens` loads them once at boot, mint/revoke
16
+ * update both sides. A restart re-reads the table, which is what makes a token
17
+ * outlive the process that minted it.
18
+ */
19
+
20
+ import { getDb } from '@/server/db.server';
21
+
22
+ interface CacheEntry {
23
+ sessionId: string;
24
+ }
25
+
26
+ declare global {
27
+ // eslint-disable-next-line no-var
28
+ var __kabmoAgentTokens: Map<string, CacheEntry> | undefined;
29
+ }
30
+
31
+ function cache(): Map<string, CacheEntry> {
32
+ globalThis.__kabmoAgentTokens ??= new Map();
33
+ return globalThis.__kabmoAgentTokens;
34
+ }
35
+
36
+ export function hashAgentToken(token: string): string {
37
+ return new Bun.CryptoHasher('sha256').update(token).digest('hex');
38
+ }
39
+
40
+ /** Load every non-revoked token hash into the gate's cache. Call once at boot. */
41
+ export async function initAgentTokens(): Promise<void> {
42
+ try {
43
+ const db = await getDb();
44
+ const rows = (await db.all(
45
+ 'SELECT session_id, token_hash FROM session_agent_tokens WHERE revoked_at IS NULL',
46
+ )) as { session_id: string; token_hash: string }[];
47
+ const next = new Map<string, CacheEntry>();
48
+ for (const row of rows) next.set(row.token_hash, { sessionId: row.session_id });
49
+ globalThis.__kabmoAgentTokens = next;
50
+ } catch {
51
+ // A database opened before this table existed has no agent credentials;
52
+ // the browser path is unaffected.
53
+ }
54
+ }
55
+
56
+ /** A fresh token VALUE, before the session id exists. */
57
+ export function createAgentToken(): string {
58
+ return `kabmo_agent_${crypto.randomUUID().replace(/-/g, '')}`;
59
+ }
60
+
61
+ /** Record the token against the session the spawn actually produced. */
62
+ export async function rememberAgentToken(sessionId: string, token: string): Promise<void> {
63
+ const hash = hashAgentToken(token);
64
+ cache().set(hash, { sessionId });
65
+ const db = await getDb();
66
+ await db.run(
67
+ `INSERT INTO session_agent_tokens (session_id, token_hash, created_at, revoked_at)
68
+ VALUES (?, ?, ?, NULL)
69
+ ON CONFLICT(session_id) DO UPDATE SET token_hash = excluded.token_hash, revoked_at = NULL`,
70
+ [sessionId, hash, Date.now()],
71
+ );
72
+ }
73
+
74
+ /** The session a bearer token identifies, or null. Synchronous by contract. */
75
+ export function verifyAgentToken(token: string | null): string | null {
76
+ if (!token) return null;
77
+ return cache().get(hashAgentToken(token))?.sessionId ?? null;
78
+ }
79
+
80
+ /** A fresh token and the environment that carries it, for a session that has no
81
+ * id yet. Every spawn path uses this so even a top-level chat can delegate. */
82
+ export function mintAgentEnvironment(): { token: string; env: Record<string, string> } {
83
+ const token = createAgentToken();
84
+ return { token, env: agentEnvironment(token) };
85
+ }
86
+
87
+ /** The value from an `Authorization: Bearer …` header, or null. */
88
+ export function bearerToken(request: Request): string | null {
89
+ const header = request.headers.get('authorization') ?? '';
90
+ const match = /^Bearer\s+(.+)$/i.exec(header.trim());
91
+ return match?.[1]?.trim() || null;
92
+ }
93
+
94
+ /** The environment a spawned child needs to reach this server. */
95
+ export function agentEnvironment(token: string): Record<string, string> {
96
+ const port = Number(Bun.env.PORT) || 3000;
97
+ return {
98
+ KABMO_AGENT_TOKEN: token,
99
+ KABMO_SERVER_URL: Bun.env.KABMO_SERVER_URL || `http://localhost:${port}`,
100
+ };
101
+ }
102
+
103
+ /**
104
+ * What a token may touch, by path.
105
+ *
106
+ * `'any'` is only spawn: a child must be allowed to create its own children.
107
+ * Every other path carries the session id it names, and the token must be that
108
+ * session's. A token is not an admin credential.
109
+ */
110
+ export function agentTokenScopeForPath(pathname: string): 'any' | string | null {
111
+ if (pathname === '/api/sessions/spawn') return 'any';
112
+ const direct = /^\/api\/(?:agent|chat)\/([^/]+)$/.exec(pathname);
113
+ if (direct) return direct[1] ?? null;
114
+ const sub = /^\/api\/sessions\/([^/]+)\/(?:fork|relations|answer)$/.exec(pathname);
115
+ return sub?.[1] ?? null;
116
+ }
117
+
118
+ /** Drop the in-memory entry for a session whose rows are being purged. */
119
+ export function forgetAgentTokenCache(sessionId: string): void {
120
+ for (const [hash, entry] of cache()) {
121
+ if (entry.sessionId === sessionId) cache().delete(hash);
122
+ }
123
+ }
124
+
125
+ export async function revokeAgentToken(sessionId: string): Promise<void> {
126
+ const db = await getDb();
127
+ await db.run('UPDATE session_agent_tokens SET revoked_at = ? WHERE session_id = ?', [
128
+ Date.now(),
129
+ sessionId,
130
+ ]);
131
+ for (const [hash, entry] of cache()) {
132
+ if (entry.sessionId === sessionId) cache().delete(hash);
133
+ }
134
+ }
@@ -0,0 +1,33 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
7
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
8
+ import { getDb } from '@/server/db.server';
9
+ import { ensureSessionRelationsSchema } from '@/server/lib/sessions/schema.server';
10
+ import { loadSessionAnswer, saveSessionAnswer } from '@/server/lib/sessions/answers.server';
11
+
12
+ beforeEach(async () => {
13
+ await isolateDb();
14
+ await ensureSessionRelationsSchema(await getDb());
15
+ });
16
+
17
+ afterEach(async () => {
18
+ await releaseDb();
19
+ });
20
+
21
+ describe('session answers', () => {
22
+ test('the last answer wins and whitespace-only text is ignored', async () => {
23
+ await saveSessionAnswer('s1', 'first');
24
+ await saveSessionAnswer('s1', ' ');
25
+ expect(await loadSessionAnswer('s1')).toBe('first');
26
+ await saveSessionAnswer('s1', 'second');
27
+ expect(await loadSessionAnswer('s1')).toBe('second');
28
+ });
29
+
30
+ test('an unknown session answers null', async () => {
31
+ expect(await loadSessionAnswer('missing')).toBeNull();
32
+ });
33
+ });
@@ -0,0 +1,37 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The last assistant text a turn closed.
8
+ *
9
+ * ACP has no transcript Kabmo can read after the process dies, so the answer a
10
+ * parent or a CLI asks for lived only in the closed message. Storing it is what
11
+ * makes `kabmo session output` and the child-outcome notice agree after a
12
+ * restart. omp rows are written too: the JSONL is authoritative, but one read
13
+ * path is simpler than two.
14
+ */
15
+
16
+ import { getDb } from '@/server/db.server';
17
+
18
+ export async function saveSessionAnswer(sessionId: string, answer: string): Promise<void> {
19
+ const text = answer.trim();
20
+ if (!text) return;
21
+ const db = await getDb();
22
+ await db.run(
23
+ `INSERT INTO session_answers (session_id, answer, updated_at)
24
+ VALUES (?, ?, ?)
25
+ ON CONFLICT(session_id) DO UPDATE SET answer = excluded.answer, updated_at = excluded.updated_at`,
26
+ [sessionId, text, Date.now()],
27
+ );
28
+ }
29
+
30
+ export async function loadSessionAnswer(sessionId: string): Promise<string | null> {
31
+ const db = await getDb();
32
+ const row = await db.get<{ answer: string }>(
33
+ 'SELECT answer FROM session_answers WHERE session_id = ?',
34
+ [sessionId],
35
+ );
36
+ return row?.answer ?? null;
37
+ }
@@ -0,0 +1,143 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The cold path's branch logic: file → RPC, recorded ACP → session/load,
8
+ * nothing resolvable → null. The deps are fakes; a real spawn is the live
9
+ * smoke's job, not a unit test's.
10
+ */
11
+
12
+ import { afterEach, beforeEach, describe, expect, test } from 'bun:test';
13
+ import { mkdtempSync } from 'node:fs';
14
+ import { tmpdir } from 'node:os';
15
+ import { join } from 'node:path';
16
+ import { isolateDb, releaseDb } from '@/test-support/isolated-db';
17
+ import { ensureSessionRelationsSchema } from '@/server/lib/sessions/schema.server';
18
+ import { getDb } from '@/server/db.server';
19
+ import { ensureSessionLive, type DispatchDeps } from '@/server/lib/sessions/dispatch.server';
20
+ import { clearSessionFileCaches } from '@/server/lib/omp/session/files';
21
+ import { saveHarnessSession } from '@/server/lib/harness/session-store.server';
22
+ import type { QueueDeliveryHost } from '@/server/lib/queue/delivery.server';
23
+
24
+ let agentRoot = '';
25
+ let savedAgentDir: string | undefined;
26
+
27
+ beforeEach(async () => {
28
+ await isolateDb();
29
+ await ensureSessionRelationsSchema(await getDb());
30
+ savedAgentDir = Bun.env.PI_CODING_AGENT_DIR;
31
+ agentRoot = mkdtempSync(join(tmpdir(), 'kabmo-dispatch-'));
32
+ Bun.env.PI_CODING_AGENT_DIR = agentRoot;
33
+ clearSessionFileCaches();
34
+ });
35
+
36
+ afterEach(async () => {
37
+ if (savedAgentDir === undefined) delete Bun.env.PI_CODING_AGENT_DIR;
38
+ else Bun.env.PI_CODING_AGENT_DIR = savedAgentDir;
39
+ clearSessionFileCaches();
40
+ await releaseDb();
41
+ });
42
+
43
+ function host(sessionId: string): QueueDeliveryHost {
44
+ return {
45
+ sessionId,
46
+ isAlive: () => true,
47
+ isBusy: () => false,
48
+ async send() {
49
+ return null;
50
+ },
51
+ };
52
+ }
53
+
54
+ function deps(overrides: Partial<DispatchDeps>): DispatchDeps {
55
+ return {
56
+ async findFile() {
57
+ return undefined;
58
+ },
59
+ async startOmp() {
60
+ throw new Error('not used');
61
+ },
62
+ async startAcp() {
63
+ throw new Error('not used');
64
+ },
65
+ ...overrides,
66
+ };
67
+ }
68
+
69
+ describe('ensureSessionLive', () => {
70
+ test('an id with no transcript, record or cwd answers null', async () => {
71
+ expect(await ensureSessionLive('missing-session', deps({}))).toBeNull();
72
+ });
73
+
74
+ test('a recorded ACP session resumes through session/load', async () => {
75
+ await saveHarnessSession({
76
+ sessionId: 'acp-1',
77
+ harness: 'claude',
78
+ agentSessionId: 'agent-1',
79
+ cwd: '/tmp/project',
80
+ });
81
+ const calls: unknown[] = [];
82
+ const result = await ensureSessionLive(
83
+ 'acp-1',
84
+ deps({
85
+ async startAcp(sessionId, harness, cwd, agentSessionId) {
86
+ calls.push({ sessionId, harness, cwd, agentSessionId });
87
+ return host(sessionId);
88
+ },
89
+ }),
90
+ );
91
+ expect(result?.sessionId).toBe('acp-1');
92
+ expect(calls).toEqual([
93
+ { sessionId: 'acp-1', harness: 'claude', cwd: '/tmp/project', agentSessionId: 'agent-1' },
94
+ ]);
95
+ });
96
+
97
+ test('a file-backed session resumes over RPC even when its record says ACP', async () => {
98
+ await saveHarnessSession({
99
+ sessionId: 'omp-acp-1',
100
+ harness: 'omp-acp',
101
+ agentSessionId: '',
102
+ cwd: '/tmp/project',
103
+ });
104
+ const calls: unknown[] = [];
105
+ const result = await ensureSessionLive(
106
+ 'omp-acp-1',
107
+ deps({
108
+ async findFile() {
109
+ return '/tmp/sessions/project/session.jsonl';
110
+ },
111
+ async startOmp(sessionId, file, cwd) {
112
+ calls.push({ sessionId, file, cwd });
113
+ return host(sessionId);
114
+ },
115
+ async startAcp() {
116
+ throw new Error('must not use session/load for an omp file');
117
+ },
118
+ }),
119
+ );
120
+ expect(result?.sessionId).toBe('omp-acp-1');
121
+ expect(calls).toEqual([
122
+ { sessionId: 'omp-acp-1', file: '/tmp/sessions/project/session.jsonl', cwd: '/tmp/project' },
123
+ ]);
124
+ });
125
+
126
+ test('a failed resume answers null rather than throwing into the caller', async () => {
127
+ await saveHarnessSession({
128
+ sessionId: 'acp-2',
129
+ harness: 'claude',
130
+ agentSessionId: 'agent-2',
131
+ cwd: '/tmp/project',
132
+ });
133
+ const result = await ensureSessionLive(
134
+ 'acp-2',
135
+ deps({
136
+ async startAcp() {
137
+ throw new Error('agent refused');
138
+ },
139
+ }),
140
+ );
141
+ expect(result).toBeNull();
142
+ });
143
+ });