@kabmo-labs/kabmo 0.24.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 (205) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +579 -510
  3. package/dist/client/static/js/index-bc9aa4mx.css +1 -0
  4. package/dist/client/static/js/{index-jcr5twtp.js → index-ga8cbpt4.js} +1072 -1174
  5. package/package.json +2 -4
  6. package/src/cli/lib/args.js +24 -1
  7. package/src/cli/lib/args.test.js +16 -0
  8. package/src/cli/lib/commands/session.js +233 -0
  9. package/src/cli/lib/commands/session.test.js +103 -0
  10. package/src/cli/main.js +1 -1
  11. package/src/client/components/common/ComposerPicker.tsx +3 -0
  12. package/src/client/components/common/code-surface/shiki.test.ts +82 -0
  13. package/src/client/components/common/code-surface/shiki.ts +28 -7
  14. package/src/client/components/common/session-actions-menu/NewChildSessionDialog.tsx +113 -0
  15. package/src/client/components/common/session-actions-menu/index.tsx +33 -2
  16. package/src/client/components/common/session-row/StatusSlot.tsx +4 -4
  17. package/src/client/components/common/session-row/index.tsx +27 -1
  18. package/src/client/components/layout/desktop-layout/resizer/separator-drag.ts +3 -3
  19. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +25 -12
  20. package/src/client/components/layout/session-sidebar/ChildSessionList.tsx +66 -0
  21. package/src/client/components/layout/session-sidebar/SessionItem.tsx +28 -3
  22. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +36 -5
  23. package/src/client/components/layout/session-sidebar/about-modal/HarnessTableLog.test.tsx +94 -0
  24. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.test.tsx +130 -0
  25. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.tsx +120 -0
  26. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +47 -0
  27. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +28 -35
  28. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +18 -5
  29. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +21 -4
  30. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +27 -5
  31. package/src/client/components/workspace/chat-timeline/ComposerDock.tsx +64 -70
  32. package/src/client/components/workspace/chat-timeline/ComposerDockFrame.tsx +35 -0
  33. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +135 -118
  34. package/src/client/components/workspace/chat-timeline/MessageItem.tsx +22 -1
  35. package/src/client/components/workspace/chat-timeline/MessageList.tsx +4 -0
  36. package/src/client/components/workspace/chat-timeline/TimelineBody.tsx +3 -0
  37. package/src/client/components/workspace/chat-timeline/composer-dock-frame.test.tsx +155 -0
  38. package/src/client/components/workspace/chat-timeline/index.tsx +3 -1
  39. package/src/client/components/workspace/terminal-panel/KeyBar.tsx +10 -8
  40. package/src/client/components/workspace/terminal-panel/{RealtimeXtermView.tsx → RealtimeTerminalView.tsx} +51 -58
  41. package/src/client/components/workspace/terminal-panel/fit.test.ts +37 -0
  42. package/src/client/components/workspace/terminal-panel/fit.ts +64 -0
  43. package/src/client/components/workspace/terminal-panel/fonts.test.ts +161 -0
  44. package/src/client/components/workspace/terminal-panel/fonts.ts +164 -0
  45. package/src/client/components/workspace/terminal-panel/grid.test.ts +52 -0
  46. package/src/client/components/workspace/terminal-panel/grid.ts +118 -0
  47. package/src/client/components/workspace/terminal-panel/index.tsx +25 -21
  48. package/src/client/components/workspace/terminal-panel/mount.ts +247 -223
  49. package/src/client/components/workspace/terminal-panel/navigation.test.ts +54 -0
  50. package/src/client/components/workspace/terminal-panel/navigation.ts +47 -0
  51. package/src/client/data/settings/omp-schema.json +1 -1
  52. package/src/client/data/theme/terminal.test.ts +25 -0
  53. package/src/client/data/theme/terminal.ts +96 -79
  54. package/src/client/hooks/chat/composer/items.test.ts +12 -26
  55. package/src/client/hooks/chat/composer/pick-mapping.test.ts +42 -0
  56. package/src/client/hooks/chat/omp/prompt-send.test.ts +7 -7
  57. package/src/client/hooks/chat/omp/prompt-send.ts +26 -14
  58. package/src/client/hooks/chat/timeline/prompt-text.test.ts +34 -1
  59. package/src/client/hooks/chat/timeline/prompt-text.ts +47 -20
  60. package/src/client/hooks/chat/timeline/send-execute.test.ts +39 -0
  61. package/src/client/hooks/chat/timeline/send-helpers.ts +30 -1
  62. package/src/client/hooks/chat/timeline/send-steer.test.ts +3 -1
  63. package/src/client/hooks/chat/timeline/send.test-util.ts +7 -1
  64. package/src/client/hooks/chat/timeline/send.test.ts +3 -1
  65. package/src/client/hooks/chat/timeline/send.ts +51 -50
  66. package/src/client/hooks/chat/timeline/use-fork-session.ts +49 -0
  67. package/src/client/hooks/models/use-harness-update.test.ts +193 -0
  68. package/src/client/hooks/models/use-harness-update.ts +202 -0
  69. package/src/client/hooks/workspace/child-expansion.ts +33 -0
  70. package/src/client/hooks/workspace/terminal/index.ts +17 -3
  71. package/src/client/hooks/workspace/terminal/socket.ts +9 -4
  72. package/src/client/lib/session-tree.test.ts +50 -0
  73. package/src/client/lib/session-tree.ts +59 -0
  74. package/src/client/tailwind.css +17 -11
  75. package/src/server/index.ts +2 -0
  76. package/src/server/lib/auth/guard.ts +10 -0
  77. package/src/server/lib/btw/session-copy.server.ts +6 -44
  78. package/src/server/lib/btw/session-copy.test.ts +2 -1
  79. package/src/server/lib/db/schema.ts +4 -0
  80. package/src/server/lib/db/seed-terminal.test.ts +1 -1
  81. package/src/server/lib/db/seed.test.ts +1 -1
  82. package/src/server/lib/harness/acp/background-work.test.ts +262 -0
  83. package/src/server/lib/harness/acp/background-work.ts +320 -0
  84. package/src/server/lib/harness/acp/client.ts +2 -2
  85. package/src/server/lib/harness/acp/gateway-env.test.ts +64 -0
  86. package/src/server/lib/harness/acp/gateway-env.ts +70 -0
  87. package/src/server/lib/harness/acp/prompt.test.ts +20 -0
  88. package/src/server/lib/harness/acp/prompt.ts +19 -3
  89. package/src/server/lib/harness/acp/session-background.test.ts +129 -0
  90. package/src/server/lib/harness/acp/session-exit.ts +31 -0
  91. package/src/server/lib/harness/acp/session-handshake.test.ts +108 -0
  92. package/src/server/lib/harness/acp/session-handshake.ts +27 -1
  93. package/src/server/lib/harness/acp/session-listeners.ts +31 -0
  94. package/src/server/lib/harness/acp/session-requests.ts +47 -0
  95. package/src/server/lib/harness/acp/session-turns.ts +20 -5
  96. package/src/server/lib/harness/acp/session.test-util.ts +23 -1
  97. package/src/server/lib/harness/acp/session.ts +59 -59
  98. package/src/server/lib/harness/acp/turn.test.ts +81 -0
  99. package/src/server/lib/harness/acp/turn.ts +26 -9
  100. package/src/server/lib/harness/acp/verbs.ts +12 -2
  101. package/src/server/lib/harness/launch.ts +3 -1
  102. package/src/server/lib/harness/spawn.server.ts +15 -2
  103. package/src/server/lib/harness/update-job-store.test.ts +126 -0
  104. package/src/server/lib/harness/update-job-store.ts +109 -0
  105. package/src/server/lib/harness/update-job.server.ts +203 -0
  106. package/src/server/lib/harness/update-worker.test.ts +153 -0
  107. package/src/server/lib/harness/update-worker.ts +197 -0
  108. package/src/server/lib/lifecycle/paths.ts +23 -0
  109. package/src/server/lib/omp/rpc/manager.ts +5 -5
  110. package/src/server/lib/omp/rpc/prewarm-pool.ts +12 -3
  111. package/src/server/lib/omp/rpc/session-registry.ts +14 -2
  112. package/src/server/lib/omp/rpc/terminal-settle.ts +53 -5
  113. package/src/server/lib/omp/session/delete-flow.server.ts +47 -0
  114. package/src/server/lib/omp/session/delete.server.ts +5 -0
  115. package/src/server/lib/omp/session/rewind-file.ts +39 -21
  116. package/src/server/lib/omp/session/sidebar-data.server.ts +6 -6
  117. package/src/server/lib/omp/session/transcript-copy.ts +123 -0
  118. package/src/server/lib/sessions/agent-token.server.test.ts +64 -0
  119. package/src/server/lib/sessions/agent-token.server.ts +134 -0
  120. package/src/server/lib/sessions/answers.server.test.ts +33 -0
  121. package/src/server/lib/sessions/answers.server.ts +37 -0
  122. package/src/server/lib/sessions/dispatch.server.test.ts +143 -0
  123. package/src/server/lib/sessions/dispatch.server.ts +128 -0
  124. package/src/server/lib/sessions/fork.server.test.ts +209 -0
  125. package/src/server/lib/sessions/fork.server.ts +304 -0
  126. package/src/server/lib/sessions/lifecycle.server.test.ts +75 -0
  127. package/src/server/lib/sessions/lifecycle.server.ts +71 -0
  128. package/src/server/lib/sessions/notify.server.test.ts +112 -0
  129. package/src/server/lib/sessions/notify.server.ts +212 -0
  130. package/src/server/lib/sessions/relation-types.ts +76 -0
  131. package/src/server/lib/sessions/relations.server.test.ts +207 -0
  132. package/src/server/lib/sessions/relations.server.ts +337 -0
  133. package/src/server/lib/sessions/resolve.server.ts +106 -0
  134. package/src/server/lib/sessions/schema.server.ts +82 -0
  135. package/src/server/lib/sessions/sidebar-relations.server.test.ts +61 -0
  136. package/src/server/lib/sessions/sidebar-relations.server.ts +47 -0
  137. package/src/server/lib/sessions/spawn.server.test.ts +196 -0
  138. package/src/server/lib/sessions/spawn.server.ts +310 -0
  139. package/src/server/lib/terminal/attach-replay.test.ts +2 -2
  140. package/src/server/lib/terminal/output.test.ts +2 -2
  141. package/src/server/lib/terminal/output.ts +1 -1
  142. package/src/server/lib/terminal/resize.test.ts +99 -0
  143. package/src/server/lib/terminal/runtime.server.ts +26 -6
  144. package/src/server/lib/terminal/send-result.test.ts +18 -1
  145. package/src/server/lib/terminal/send-result.ts +26 -2
  146. package/src/server/lib/terminal/session.server.ts +6 -6
  147. package/src/server/lib/usage/new-api.test.ts +92 -0
  148. package/src/server/lib/usage/new-api.ts +131 -0
  149. package/src/server/lib/usage/provider-endpoint.test.ts +106 -0
  150. package/src/server/lib/usage/provider-key.ts +33 -0
  151. package/src/server/lib/usage/providers.server.ts +10 -3
  152. package/src/server/lib/usage/vendor-balance.server.ts +4 -53
  153. package/src/server/lib/usage/vendor-http.ts +41 -0
  154. package/src/server/lib/usage/window.ts +55 -0
  155. package/src/server/routes/agent/command.ts +14 -1
  156. package/src/server/routes/agent/harness-command.ts +6 -0
  157. package/src/server/routes/agent/new.ts +15 -0
  158. package/src/server/routes/harness/add-provider.test.ts +9 -1
  159. package/src/server/routes/harness/import-action.ts +4 -0
  160. package/src/server/routes/harness/import.test.ts +1 -1
  161. package/src/server/routes/harness/index.ts +5 -1
  162. package/src/server/routes/harness/update-status.ts +26 -0
  163. package/src/server/routes/harness/update.test.ts +119 -0
  164. package/src/server/routes/harness/update.ts +59 -147
  165. package/src/server/routes/sessions/answer.ts +24 -0
  166. package/src/server/routes/sessions/batch-delete.ts +11 -5
  167. package/src/server/routes/sessions/delete.ts +4 -2
  168. package/src/server/routes/sessions/fork.ts +74 -0
  169. package/src/server/routes/sessions/index.ts +14 -0
  170. package/src/server/routes/sessions/relations.ts +85 -0
  171. package/src/server/routes/sessions/session.ts +4 -0
  172. package/src/server/routes/sessions/spawn.ts +134 -0
  173. package/src/server/routes/terminal/ws.ts +3 -3
  174. package/src/shared/lib/chat/composer/client.ts +31 -2
  175. package/src/shared/lib/chat/composer/delegation.test.ts +93 -0
  176. package/src/shared/lib/chat/composer/delegation.ts +206 -0
  177. package/src/shared/lib/chat/notice-text.ts +1 -1
  178. package/src/shared/lib/chat/tool/summary-wait.test.ts +11 -0
  179. package/src/shared/lib/code/ansi.ts +1 -1
  180. package/src/shared/lib/fonts/nerd-symbols.css +4 -3
  181. package/src/shared/lib/fonts/nerd-symbols.test.ts +9 -9
  182. package/src/shared/lib/harness/provider-facts.test.ts +27 -0
  183. package/src/shared/lib/harness/providers.ts +35 -1
  184. package/src/shared/lib/harness/update-job.ts +33 -0
  185. package/src/shared/lib/harness/update-plan.test.ts +21 -6
  186. package/src/shared/lib/harness/update-plan.ts +12 -4
  187. package/src/shared/lib/omp/session/wait-idle.test.ts +11 -0
  188. package/src/shared/lib/omp/session/wait-idle.ts +12 -2
  189. package/src/shared/lib/theme/catalog.test.ts +13 -9
  190. package/src/shared/lib/theme/color.test.ts +2 -2
  191. package/src/shared/lib/theme/color.ts +4 -4
  192. package/src/shared/lib/theme/theme.test.ts +1 -1
  193. package/src/shared/lib/workspace/terminal/input.test.ts +27 -0
  194. package/src/shared/lib/workspace/terminal/input.ts +33 -0
  195. package/src/shared/lib/workspace/terminal/keys.test.ts +1 -1
  196. package/src/shared/lib/workspace/terminal/keys.ts +7 -7
  197. package/src/shared/types/chat.ts +1 -1
  198. package/src/shared/types/harness-update.ts +65 -0
  199. package/src/shared/types/omp/agent.ts +19 -2
  200. package/src/shared/types/workspace.ts +4 -0
  201. package/src/test-support/fake-omp-fork.ts +16 -2
  202. package/src/test-support/harness-table.test-util.ts +15 -1
  203. package/dist/client/static/js/index-z3w7n85q.css +0 -1
  204. package/src/client/components/workspace/terminal-panel/webgl.test.ts +0 -75
  205. package/src/client/components/workspace/terminal-panel/webgl.ts +0 -108
@@ -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
+ });
@@ -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
+ });