@kabmo-labs/kabmo 0.25.0 → 0.26.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (188) hide show
  1. package/dist/client/index.html +1 -1
  2. package/dist/client/index.js +440 -436
  3. package/dist/client/static/js/{index-ga8cbpt4.js → index-95b3n20k.js} +945 -945
  4. package/dist/client/static/js/index-p2yw9ywf.css +1 -0
  5. package/package.json +1 -1
  6. package/src/client/components/common/session-actions-menu/index.tsx +38 -12
  7. package/src/client/components/common/session-branch/BranchGuides.tsx +93 -0
  8. package/src/client/components/common/session-branch/SubagentRow.tsx +77 -0
  9. package/src/client/components/common/session-branch/index.tsx +169 -0
  10. package/src/client/components/common/session-branch/session-branch.test.tsx +240 -0
  11. package/src/client/components/common/session-branch/style.ts +29 -0
  12. package/src/client/components/common/session-row/StatusSlot.tsx +15 -3
  13. package/src/client/components/common/session-row/index.tsx +24 -25
  14. package/src/client/components/common/session-row/session-row.test.tsx +11 -0
  15. package/src/client/components/common/session-state-provider/index.tsx +1 -1
  16. package/src/client/components/layout/session-sidebar/CategoryItem.tsx +64 -68
  17. package/src/client/components/layout/session-sidebar/SessionItem.batch.test.ts +3 -3
  18. package/src/client/components/layout/session-sidebar/SessionItem.test.ts +25 -2
  19. package/src/client/components/layout/session-sidebar/SessionItem.tsx +33 -30
  20. package/src/client/components/layout/session-sidebar/about-modal/HarnessRow.tsx +261 -0
  21. package/src/client/components/layout/session-sidebar/about-modal/HarnessTable.tsx +35 -225
  22. package/src/client/components/layout/session-sidebar/about-modal/HarnessTableLog.test.tsx +36 -16
  23. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogDialog.tsx +11 -3
  24. package/src/client/components/layout/session-sidebar/about-modal/UpdateLogLine.tsx +13 -4
  25. package/src/client/components/layout/session-sidebar/about-modal/index.tsx +28 -13
  26. package/src/client/components/layout/session-sidebar/modern/WorkspaceSection.tsx +59 -57
  27. package/src/client/components/mobile/mobile-session-sidebar/Item.tsx +57 -61
  28. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.test.ts +5 -0
  29. package/src/client/components/mobile/mobile-session-sidebar/SessionRow.tsx +33 -30
  30. package/src/client/components/settings/Sidebar.tsx +1 -1
  31. package/src/client/components/settings/categories/NotificationSettings.test.tsx +92 -0
  32. package/src/client/components/settings/categories/NotificationSettings.tsx +112 -2
  33. package/src/client/components/settings/categories/harness-settings/HarnessCard.tsx +1 -1
  34. package/src/client/components/workspace/chat-timeline/AiMessageFooter.fork.test.ts +94 -0
  35. package/src/client/components/workspace/chat-timeline/AiMessageFooter.tsx +31 -5
  36. package/src/client/components/workspace/chat-timeline/EmptyWorkspacePrompt.tsx +28 -39
  37. package/src/client/components/workspace/chat-timeline/MessageList.tsx +7 -5
  38. package/src/client/components/workspace/chat-timeline/PendingChatView.tsx +10 -0
  39. package/src/client/components/workspace/chat-timeline/RunFooter.tsx +12 -3
  40. package/src/client/components/workspace/chat-timeline/chat-input/AttachmentToolbar.tsx +2 -0
  41. package/src/client/components/workspace/chat-timeline/chat-input/ModeToggles.tsx +15 -1
  42. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.test.tsx +85 -0
  43. package/src/client/components/workspace/chat-timeline/chat-input/SessionModeDropdown.tsx +84 -0
  44. package/src/client/components/workspace/chat-timeline/chat-input/Toolbar.tsx +2 -0
  45. package/src/client/components/workspace/chat-timeline/chat-input/modes-props.ts +5 -0
  46. package/src/client/components/workspace/chat-timeline/index.tsx +10 -21
  47. package/src/client/components/workspace/chat-timeline/target-picker/DraftTargetRow.tsx +115 -0
  48. package/src/client/components/workspace/chat-timeline/target-picker/ParentSessionPicker.tsx +173 -0
  49. package/src/client/components/workspace/chat-timeline/target-picker/parent-session-options.test.ts +49 -0
  50. package/src/client/hooks/chat/composer/items.test.ts +19 -0
  51. package/src/client/hooks/chat/omp/folder-auto-expand.ts +1 -1
  52. package/src/client/hooks/chat/omp/pending-adoption.ts +51 -0
  53. package/src/client/hooks/chat/omp/pending-child.test.ts +73 -0
  54. package/src/client/hooks/chat/omp/pending-entry.ts +59 -0
  55. package/src/client/hooks/chat/omp/pending-rows.ts +6 -2
  56. package/src/client/hooks/chat/omp/pending-sessions.test.ts +1 -2
  57. package/src/client/hooks/chat/omp/pending-sessions.ts +45 -69
  58. package/src/client/hooks/chat/omp/pending-waiting.ts +1 -1
  59. package/src/client/hooks/chat/omp/run-switch.ts +1 -1
  60. package/src/client/hooks/chat/omp/session-list.tsx +4 -0
  61. package/src/client/hooks/chat/subagents/roster.ts +122 -0
  62. package/src/client/hooks/chat/timeline/child-spawn.test.ts +55 -0
  63. package/src/client/hooks/chat/timeline/child-spawn.ts +45 -0
  64. package/src/client/hooks/chat/timeline/fork-request.test.ts +54 -0
  65. package/src/client/hooks/chat/timeline/fork-request.ts +43 -0
  66. package/src/client/hooks/chat/timeline/mode-availability.test.ts +1 -1
  67. package/src/client/hooks/chat/timeline/mode-availability.ts +33 -0
  68. package/src/client/hooks/chat/timeline/mode-markers.ts +7 -1
  69. package/src/client/hooks/chat/timeline/mode-post.ts +15 -3
  70. package/src/client/hooks/chat/timeline/modes-contract.ts +9 -4
  71. package/src/client/hooks/chat/timeline/modes.test.ts +56 -18
  72. package/src/client/hooks/chat/timeline/modes.ts +42 -29
  73. package/src/client/hooks/chat/timeline/pending-branch.ts +205 -0
  74. package/src/client/hooks/chat/timeline/pending-dispatch.ts +253 -0
  75. package/src/client/hooks/chat/timeline/send.ts +17 -103
  76. package/src/client/hooks/chat/timeline/session-harness.ts +6 -0
  77. package/src/client/hooks/chat/timeline/stop-with-queue.ts +42 -0
  78. package/src/client/hooks/chat/timeline/use-fork-session.ts +40 -31
  79. package/src/client/hooks/models/use-harness-update.test.ts +137 -44
  80. package/src/client/hooks/models/use-harness-update.ts +133 -85
  81. package/src/client/hooks/ui/input-required-alert.ts +12 -5
  82. package/src/client/hooks/ui/notifications.ts +45 -0
  83. package/src/client/hooks/ui/run-outcome-alert.ts +48 -0
  84. package/src/client/hooks/workspace/expanded-sessions.ts +36 -7
  85. package/src/client/lib/native/open-session.ts +33 -0
  86. package/src/client/lib/notifications/os.test.ts +125 -0
  87. package/src/client/lib/notifications/os.ts +130 -0
  88. package/src/client/lib/plugins/sidebar-bridge.ts +2 -20
  89. package/src/client/lib/router/open-session.test.ts +75 -0
  90. package/src/client/lib/router/open-session.ts +34 -0
  91. package/src/client/lib/signals.ts +5 -1
  92. package/src/client/main.tsx +6 -0
  93. package/src/server/lib/db/schema.ts +1 -0
  94. package/src/server/lib/harness/acp/calls.ts +15 -1
  95. package/src/server/lib/harness/acp/client-capabilities.test.ts +55 -0
  96. package/src/server/lib/harness/acp/client-capabilities.ts +61 -0
  97. package/src/server/lib/harness/acp/client-fs.test.ts +135 -0
  98. package/src/server/lib/harness/acp/client-fs.ts +131 -0
  99. package/src/server/lib/harness/acp/client-initialize.test.ts +70 -0
  100. package/src/server/lib/harness/acp/client-initialize.ts +84 -0
  101. package/src/server/lib/harness/acp/client.ts +31 -21
  102. package/src/server/lib/harness/acp/commands.test.ts +5 -5
  103. package/src/server/lib/harness/acp/commands.ts +14 -2
  104. package/src/server/lib/harness/acp/frames-timing.test.ts +68 -0
  105. package/src/server/lib/harness/acp/frames-v2.test.ts +85 -0
  106. package/src/server/lib/harness/acp/frames.ts +71 -158
  107. package/src/server/lib/harness/acp/mapper.test.ts +40 -0
  108. package/src/server/lib/harness/acp/mapper.ts +12 -0
  109. package/src/server/lib/harness/acp/permissions.ts +6 -0
  110. package/src/server/lib/harness/acp/protocol.ts +41 -2
  111. package/src/server/lib/harness/acp/session-facts.ts +1 -1
  112. package/src/server/lib/harness/acp/session-handshake.test.ts +90 -1
  113. package/src/server/lib/harness/acp/session-handshake.ts +83 -6
  114. package/src/server/lib/harness/acp/session-idle.ts +7 -6
  115. package/src/server/lib/harness/acp/session-notifications.ts +41 -2
  116. package/src/server/lib/harness/acp/session-observers.test.ts +63 -0
  117. package/src/server/lib/harness/acp/session-permissions.test.ts +29 -0
  118. package/src/server/lib/harness/acp/session-permissions.ts +36 -0
  119. package/src/server/lib/harness/acp/session-requests.test.ts +92 -0
  120. package/src/server/lib/harness/acp/session-requests.ts +48 -6
  121. package/src/server/lib/harness/acp/session-turns.ts +8 -3
  122. package/src/server/lib/harness/acp/session-usage.ts +4 -0
  123. package/src/server/lib/harness/acp/session-web-state.ts +30 -2
  124. package/src/server/lib/harness/acp/session.test-util.ts +19 -1
  125. package/src/server/lib/harness/acp/session.ts +60 -60
  126. package/src/server/lib/harness/acp/tool-calls.ts +223 -0
  127. package/src/server/lib/harness/acp/turn.test.ts +102 -0
  128. package/src/server/lib/harness/acp/turn.ts +81 -6
  129. package/src/server/lib/harness/acp/v2.test.ts +144 -0
  130. package/src/server/lib/harness/acp/v2.ts +220 -0
  131. package/src/server/lib/harness/acp/verbs.ts +46 -6
  132. package/src/server/lib/harness/launch.test.ts +25 -0
  133. package/src/server/lib/harness/launch.ts +21 -9
  134. package/src/server/lib/harness/session.ts +3 -0
  135. package/src/server/lib/harness/update-job-store.test.ts +37 -12
  136. package/src/server/lib/harness/update-job-store.ts +22 -16
  137. package/src/server/lib/harness/update-job.server.ts +66 -175
  138. package/src/server/lib/harness/update-queue.server.ts +292 -0
  139. package/src/server/lib/harness/update-queue.test.ts +265 -0
  140. package/src/server/lib/harness/update-spawn.server.ts +96 -0
  141. package/src/server/lib/harness/update-worker.ts +8 -3
  142. package/src/server/lib/lifecycle/after-listen.ts +9 -0
  143. package/src/server/lib/lifecycle/paths.ts +14 -9
  144. package/src/server/lib/omp/rpc/run-settle.server.ts +10 -1
  145. package/src/server/lib/omp/rpc/subagent-liveness.ts +5 -5
  146. package/src/server/lib/omp/rpc/terminal-settle.ts +5 -1
  147. package/src/server/lib/omp/session/delete-flow.server.ts +1 -0
  148. package/src/server/lib/omp/session/sidebar-data.server.ts +10 -12
  149. package/src/server/lib/sessions/fork.server.test.ts +68 -0
  150. package/src/server/lib/sessions/fork.server.ts +31 -6
  151. package/src/server/lib/sessions/spawn.server.test.ts +41 -0
  152. package/src/server/lib/sessions/spawn.server.ts +27 -2
  153. package/src/server/routes/agent/harness-command.ts +6 -5
  154. package/src/server/routes/chat/stream.ts +7 -2
  155. package/src/server/routes/harness/update-status.ts +18 -12
  156. package/src/server/routes/harness/update.test.ts +53 -16
  157. package/src/server/routes/harness/update.ts +13 -8
  158. package/src/server/routes/sessions/body-readers.ts +43 -0
  159. package/src/server/routes/sessions/fork.ts +19 -4
  160. package/src/server/routes/sessions/routes.test.ts +1 -2
  161. package/src/server/routes/sessions/session.ts +19 -0
  162. package/src/server/routes/sessions/spawn.ts +16 -13
  163. package/src/shared/lib/chat/omp/agent-events.ts +11 -0
  164. package/src/shared/lib/chat/omp/session-modes-signal.test.ts +41 -0
  165. package/src/shared/lib/harness/mode-signal.ts +20 -0
  166. package/src/shared/lib/harness/session-modes.ts +24 -0
  167. package/src/shared/lib/harness/update-job.ts +53 -6
  168. package/src/shared/lib/icons/tint-hues.generated.ts +34 -34
  169. package/src/shared/lib/notifications/outcomes.test.ts +96 -0
  170. package/src/shared/lib/notifications/outcomes.ts +64 -0
  171. package/src/shared/lib/notifications/settings.test.ts +49 -0
  172. package/src/shared/lib/notifications/settings.ts +34 -0
  173. package/src/shared/lib/omp/session/default-title.ts +5 -4
  174. package/src/shared/lib/omp/session/prewarm-misc.test.ts +3 -2
  175. package/src/shared/lib/omp/session/schema-migrations.ts +4 -0
  176. package/src/shared/lib/omp/session/stream-state.server.test.ts +19 -0
  177. package/src/shared/lib/omp/session/stream-state.server.ts +24 -4
  178. package/src/shared/lib/settings/defaults.ts +3 -0
  179. package/src/shared/types/harness-update.ts +24 -0
  180. package/src/shared/types/realtime.ts +2 -0
  181. package/src/shared/types/settings/state.ts +10 -0
  182. package/src/shared/types/workspace.ts +4 -0
  183. package/src/test-support/harness-table.test-util.ts +25 -9
  184. package/dist/client/static/js/index-bc9aa4mx.css +0 -1
  185. package/src/client/components/common/session-actions-menu/NewChildSessionDialog.tsx +0 -113
  186. package/src/client/components/common/subagent-list/index.tsx +0 -165
  187. package/src/client/components/layout/session-sidebar/ChildSessionList.tsx +0 -66
  188. package/src/client/hooks/workspace/child-expansion.ts +0 -33
@@ -0,0 +1,73 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The pending row a "New child session" click creates.
8
+ *
9
+ * A child is a pending chat like any other — same store, same lifetime — but it
10
+ * must land INSIDE its parent's branch and keep its branch slot, harness and
11
+ * "New Child" title across the id switch a spawn performs. Both facts are
12
+ * asserted here rather than in the store suite, because they are the ones the
13
+ * tree depends on.
14
+ */
15
+
16
+ import { beforeEach, describe, expect, test } from 'bun:test';
17
+
18
+ import {
19
+ adoptPendingSession,
20
+ listPendingSessions,
21
+ releasePendingSession,
22
+ startPendingSession,
23
+ } from '@/client/hooks/chat/omp/pending-sessions';
24
+ import { withPendingRows } from '@/client/hooks/chat/omp/pending-rows';
25
+ import { buildSessionTree } from '@/client/lib/session-tree';
26
+ import { formatNewSessionTitle } from '@/shared/lib/omp/session/default-title';
27
+ import type { WorkspaceFolderData } from '@/shared/types';
28
+
29
+ function folders(...ids: string[]): WorkspaceFolderData[] {
30
+ return [{
31
+ id: 1,
32
+ name: 'ws',
33
+ isExpanded: false,
34
+ hasMore: false,
35
+ totalSessions: ids.length,
36
+ sessions: ids.map((id) => ({ id, folder_id: 1, title: id.toUpperCase() })),
37
+ }];
38
+ }
39
+
40
+ function clear(): void {
41
+ for (const entry of listPendingSessions()) releasePendingSession(entry.id);
42
+ }
43
+
44
+ beforeEach(clear);
45
+
46
+ describe('pending child rows', () => {
47
+ test('a pending CHILD nests under its parent, with its harness and title', () => {
48
+ const title = formatNewSessionTitle(new Date(), 'New Child');
49
+ const id = startPendingSession(1, { parentSessionId: 'real-1', harness: 'claude', title });
50
+
51
+ const out = withPendingRows(folders('real-1'), listPendingSessions(), { activeId: 'real-1' });
52
+ const tree = buildSessionTree(out[0]?.sessions ?? []);
53
+ const child = tree.childrenOf.get('real-1')?.[0];
54
+ expect(tree.roots.map((session) => session.id)).toEqual(['real-1']);
55
+ expect(child?.id).toBe(id);
56
+ expect(child?.parentSessionId).toBe('real-1');
57
+ expect(child?.harness).toBe('claude');
58
+ expect(child?.title).toBe(title);
59
+ });
60
+
61
+ test('adoption keeps a child in its branch after the id switch', () => {
62
+ const title = formatNewSessionTitle(new Date(), 'New Child');
63
+ const id = startPendingSession(1, { parentSessionId: 'real-1', harness: 'claude', title });
64
+
65
+ adoptPendingSession(id, 'omp-child', 1);
66
+ const adopted = listPendingSessions().find((entry) => entry.id === 'omp-child');
67
+ expect(adopted?.parentSessionId).toBe('real-1');
68
+ expect(adopted?.harness).toBe('claude');
69
+ expect(adopted?.title).toBe(title);
70
+ // The old pending id is gone: one row, not two.
71
+ expect(listPendingSessions().some((entry) => entry.id === id)).toBe(false);
72
+ });
73
+ });
@@ -0,0 +1,59 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * One row the client draws before omp's transcript scan can see the session.
8
+ *
9
+ * Split from the store that owns its lifetime (`pending-sessions.ts`): the
10
+ * type is what three modules share, and keeping it here is what lets the store
11
+ * stay inside the file-size ceiling without a second shape.
12
+ */
13
+
14
+ export interface PendingSessionEntry {
15
+ /** Client-side `new-<epoch>` id, or the omp UUID a spawn adopted. */
16
+ id: string;
17
+ /** The folder the row belongs to; null resolves from the active session. */
18
+ folderId: number | string | null;
19
+ /** Epoch ms the chat was started — stable across adoption and reloads, so
20
+ * neither the title nor the ordering can churn on a revalidate. */
21
+ createdAt: number;
22
+ /** Epoch ms a prompt was dispatched for this chat, or null while it is a
23
+ * draft the user has not sent in. */
24
+ sentAt: number | null;
25
+ /**
26
+ * Set while this chat's prompt is HELD for another session to finish.
27
+ *
28
+ * The row is drawn exactly as it was before the send — same id, same folder —
29
+ * because the session does not exist yet: what the user asked for is that the
30
+ * row stays put and says what it is waiting on. `waitId` is the server row
31
+ * that owns the wait, so cancelling from the row reaches it.
32
+ */
33
+ waiting?: {
34
+ waitId: string;
35
+ dependsOn: string;
36
+ dependsOnTitle: string | null;
37
+ };
38
+ /**
39
+ * The session this pending chat is a CHILD of, when it was started from that
40
+ * row's "New child session" menu. Absent for a top-level New Session.
41
+ *
42
+ * Carried onto the sidebar row so `buildSessionTree` can nest the row under
43
+ * its parent from the first frame — the child exists client-side before omp's
44
+ * transcript scan can see it, exactly like any pending chat.
45
+ */
46
+ parentSessionId?: string;
47
+ /** Harness picked for a pending child, so its mark is drawn before spawn. */
48
+ harness?: string;
49
+ /** Row title override: a pending child names itself "New Child - …". */
50
+ title?: string;
51
+ /**
52
+ * The session this pending chat BRANCHES from, when the Fork button started
53
+ * it. A fork is not a child: it records a source edge, not a parent, so this
54
+ * is kept apart from `parentSessionId`.
55
+ */
56
+ forkSourceSessionId?: string;
57
+ /** The transcript entry the fork cuts at; absent means the source's tip. */
58
+ forkAnchorEntryId?: string;
59
+ }
@@ -15,7 +15,7 @@
15
15
 
16
16
  import type { SessionItemData, WorkspaceFolderData } from '@/shared/types';
17
17
  import { pendingSessionTitle } from '@/shared/lib/omp/session/default-title';
18
- import type { PendingSessionEntry } from '@/client/hooks/chat/omp/pending-sessions';
18
+ import type { PendingSessionEntry } from '@/client/hooks/chat/omp/pending-entry';
19
19
 
20
20
  export interface PendingRowOptions {
21
21
  /** The session the URL has open; its folder is the fallback host. */
@@ -58,12 +58,16 @@ export function withPendingRows(
58
58
  const row: SessionItemData = {
59
59
  id: entry.id,
60
60
  folder_id: target.id,
61
- title: options.titleFor?.(String(entry.id)) ?? pendingSessionTitle(entry.id),
61
+ title: entry.title ?? options.titleFor?.(String(entry.id)) ?? pendingSessionTitle(entry.id),
62
62
  // The id's own clock, never `Date.now()`: the row is ranked by
63
63
  // `updated_at`, and a re-stamp on every revalidate kept it perpetually
64
64
  // newest and reshuffled LATEST_SESSION ordering mid-run.
65
65
  created_at: stamp,
66
66
  updated_at: stamp,
67
+ // A pending CHILD nests under its parent from the first frame; the tree
68
+ // builder does the rest, so no second placement rule exists.
69
+ ...(entry.parentSessionId ? { parentSessionId: entry.parentSessionId } : {}),
70
+ ...(entry.harness ? { harness: entry.harness } : {}),
67
71
  // The row's own reason for existing past the click: its prompt is held.
68
72
  ...(entry.waiting
69
73
  ? { waitingFor: { waitId: entry.waiting.waitId, sessionId: entry.waiting.dependsOn, title: entry.waiting.dependsOnTitle } }
@@ -20,8 +20,6 @@ import { beforeEach, describe, expect, test } from 'bun:test';
20
20
 
21
21
  import {
22
22
  adoptPendingSession,
23
- consumeAdoption,
24
- isSpawnAdoption,
25
23
  hydratePendingSession,
26
24
  listPendingSessions,
27
25
  markPendingSessionSent,
@@ -31,6 +29,7 @@ import {
31
29
  releasePendingSession,
32
30
  startPendingSession,
33
31
  } from '@/client/hooks/chat/omp/pending-sessions';
32
+ import { consumeAdoption, isSpawnAdoption } from '@/client/hooks/chat/omp/pending-adoption';
34
33
  import { pendingHostFolderIds, withPendingRows } from '@/client/hooks/chat/omp/pending-rows';
35
34
  import { formatNewSessionTitle } from '@/shared/lib/omp/session/default-title';
36
35
  import { forgetSession, getSessionValue, setSessionKey } from '@/shared/lib/workspace/session-state/store';
@@ -42,36 +42,12 @@
42
42
  */
43
43
 
44
44
  import { useEffect, useState } from 'preact/hooks';
45
+ import { recordAdoption } from '@/client/hooks/chat/omp/pending-adoption';
46
+ import type { PendingSessionEntry } from '@/client/hooks/chat/omp/pending-entry';
45
47
  import { pendingSessionCreatedAt, sessionIdEpochMs } from '@/shared/lib/omp/session/default-title';
46
48
  import { getSessionState } from '@/shared/lib/workspace/session-state/store';
47
49
  import { hasComposerDraft } from '@/shared/lib/chat/composer/draft';
48
50
 
49
- export interface PendingSessionEntry {
50
- /** Client-side `new-<epoch>` id, or the omp UUID a spawn adopted. */
51
- id: string;
52
- /** The folder the row belongs to; null resolves from the active session. */
53
- folderId: number | string | null;
54
- /** Epoch ms the chat was started — stable across adoption and reloads, so
55
- * neither the title nor the ordering can churn on a revalidate. */
56
- createdAt: number;
57
- /** Epoch ms a prompt was dispatched for this chat, or null while it is a
58
- * draft the user has not sent in. */
59
- sentAt: number | null;
60
- /**
61
- * Set while this chat's prompt is HELD for another session to finish.
62
- *
63
- * The row is drawn exactly as it was before the send — same id, same folder —
64
- * because the session does not exist yet: what the user asked for is that the
65
- * row stays put and says what it is waiting on. `waitId` is the server row
66
- * that owns the wait, so cancelling from the row reaches it.
67
- */
68
- waiting?: {
69
- waitId: string;
70
- dependsOn: string;
71
- dependsOnTitle: string | null;
72
- };
73
- }
74
-
75
51
  /** How long a SENT entry may outlive its switch with no real row behind it.
76
52
  * Measured against omp's own write (buffered until the first assistant message
77
53
  * settles, ~17s), so it is set comfortably past that. */
@@ -81,11 +57,6 @@ export const PENDING_SETTLE_MS = 30_000;
81
57
  export const MAX_UNSENT_DRAFTS = 3;
82
58
 
83
59
  const entries = new Map<string, PendingSessionEntry>();
84
- /** `toId → fromId` for a spawn adoption, consumed by the session-state
85
- * provider so a plain switch away from a pending chat cannot be mistaken for
86
- * one. Bounded by the pending store itself: an entry is written where an
87
- * adoption happens and dropped the moment it is claimed. */
88
- const adoptions = new Map<string, string>();
89
60
  const listeners = new Set<() => void>();
90
61
 
91
62
  function emit(): void {
@@ -111,6 +82,11 @@ function upsert(entry: PendingSessionEntry): void {
111
82
  && current.folderId === entry.folderId
112
83
  && current.createdAt === entry.createdAt
113
84
  && current.sentAt === entry.sentAt
85
+ && current.parentSessionId === entry.parentSessionId
86
+ && current.harness === entry.harness
87
+ && current.title === entry.title
88
+ && current.forkSourceSessionId === entry.forkSourceSessionId
89
+ && current.forkAnchorEntryId === entry.forkAnchorEntryId
114
90
  && sameWait
115
91
  ) {
116
92
  return;
@@ -125,8 +101,22 @@ function upsert(entry: PendingSessionEntry): void {
125
101
  * The id is what the URL carries (`?sessionId=new-…`) until a spawn adopts a
126
102
  * real one, so the caller writes the returned value rather than minting its own
127
103
  * — an id the store does not know is a row nothing can draw.
104
+ *
105
+ * `options` is what makes the row a CHILD: the parent it nests under, the
106
+ * harness its mark should draw, and the title that says "New Child". A child is
107
+ * still a pending chat — same store, same lifetime rules — only its branch slot
108
+ * differs.
128
109
  */
129
- export function startPendingSession(folderId: number | string | null): string {
110
+ export function startPendingSession(
111
+ folderId: number | string | null,
112
+ options: {
113
+ parentSessionId?: string;
114
+ harness?: string;
115
+ title?: string;
116
+ forkSourceSessionId?: string;
117
+ forkAnchorEntryId?: string;
118
+ } = {},
119
+ ): string {
130
120
  // `new-<epochMs>` stays parseable by `pendingSessionCreatedAt`, which is what
131
121
  // keeps the row's title and stamp still across revalidates — so two clicks in
132
122
  // the same millisecond step the clock instead of gaining a suffix, which
@@ -134,7 +124,17 @@ export function startPendingSession(folderId: number | string | null): string {
134
124
  let epoch = Date.now();
135
125
  while (entries.has(`new-${epoch}`)) epoch += 1;
136
126
  const id = `new-${epoch}`;
137
- upsert({ id, folderId, createdAt: epoch, sentAt: null });
127
+ upsert({
128
+ id,
129
+ folderId,
130
+ createdAt: epoch,
131
+ sentAt: null,
132
+ ...(options.parentSessionId ? { parentSessionId: options.parentSessionId } : {}),
133
+ ...(options.harness ? { harness: options.harness } : {}),
134
+ ...(options.title ? { title: options.title } : {}),
135
+ ...(options.forkSourceSessionId ? { forkSourceSessionId: options.forkSourceSessionId } : {}),
136
+ ...(options.forkAnchorEntryId ? { forkAnchorEntryId: options.forkAnchorEntryId } : {}),
137
+ });
138
138
  // Repeated New Session clicks are the one way this map grows without a
139
139
  // bound: each click is a row the user may never send in. Oldest drafts go,
140
140
  // and a SENT entry is never a candidate — its transcript is on the way.
@@ -171,52 +171,23 @@ export function adoptPendingSession(
171
171
  // Recorded for the session-state provider, which must NOT carry the pending
172
172
  // slot's UI state onto just any id the URL moves to — only onto the one a
173
173
  // spawn answered with. See `consumeAdoption`.
174
- if (fromId) adoptions.set(toId, fromId);
174
+ if (fromId) recordAdoption(fromId, toId);
175
175
  upsert({
176
176
  id: toId,
177
177
  folderId: from?.folderId ?? folderId ?? null,
178
178
  createdAt: from?.createdAt ?? createdAtFor(toId),
179
179
  sentAt: from?.sentAt ?? Date.now(),
180
+ // The child stays a child (and keeps its harness and "New Child" title)
181
+ // across the id switch, so the row does not jump out of its branch or
182
+ // change its mark while the real session's own title is still on the way.
183
+ ...(from?.parentSessionId ? { parentSessionId: from.parentSessionId } : {}),
184
+ ...(from?.harness ? { harness: from.harness } : {}),
185
+ ...(from?.title ? { title: from.title } : {}),
180
186
  // The wait ended when the spawn answered: the new row is a real session
181
187
  // from this moment, and a cue left on it would say it is still held.
182
188
  });
183
189
  }
184
190
 
185
- /**
186
- * Whether `toId` is the id a spawn answered with for `fromId` — consuming the
187
- * record so one adoption is claimed once.
188
- *
189
- * The session-state provider used to treat EVERY move away from a `new-…` id as
190
- * an adoption and migrate the transient slot's whole UI state onto whatever the
191
- * URL now named. Clicking another session from a pending chat is the same
192
- * transition, so the pending chat's DRAFT was copied into that session and
193
- * persisted there (measured: a POST for the other session carrying
194
- * `chat.draft`). Only a real spawn may carry the state across.
195
- */
196
- export function consumeAdoption(fromId: string | null | undefined, toId: string): boolean {
197
- if (!fromId || adoptions.get(toId) !== fromId) return false;
198
- adoptions.delete(toId);
199
- return true;
200
- }
201
-
202
- /**
203
- * Whether `toId` is the id a spawn answered with for `fromId`, WITHOUT claiming
204
- * the record.
205
- *
206
- * The agent hook asks a different question from the session-state provider's:
207
- * not "may I carry this UI state across", but "is this the SAME conversation
208
- * under a new id". A spawn adoption is exactly that, and treating it as a
209
- * session switch threw away the run's own bookkeeping — `toolResultsRef` and
210
- * `lastToolMessageRef` — in the middle of the first turn: measured in a browser
211
- * spec, the tool-call map was cleared between two progress frames, so every
212
- * later `tool_execution_update`/`_end` had no target to pair onto and the card
213
- * froze at `running` for the rest of the session. The provider still owns the
214
- * single claim (`consumeAdoption`), so peeking here cannot steal it.
215
- */
216
- export function isSpawnAdoption(fromId: string | null | undefined, toId: string): boolean {
217
- return Boolean(fromId) && adoptions.get(toId) === fromId;
218
- }
219
-
220
191
  /**
221
192
  * Register an id the URL names but this store does not know.
222
193
  *
@@ -267,6 +238,11 @@ export function listPendingSessions(): PendingSessionEntry[] {
267
238
  return [...entries.values()];
268
239
  }
269
240
 
241
+ /** One entry by id — the send path's read of the chat's own parent. */
242
+ export function pendingEntryFor(id: string | null | undefined): PendingSessionEntry | undefined {
243
+ return id ? entries.get(id) : undefined;
244
+ }
245
+
270
246
  /** Drop the entries the authoritative list has superseded, plus stale sends. */
271
247
  export function reconcilePendingSessions(input: {
272
248
  /** Session ids the structure's own payload carries. */
@@ -13,7 +13,7 @@
13
13
  * written through the same map, the same emit and the same no-op check.
14
14
  */
15
15
 
16
- import type { PendingSessionEntry } from '@/client/hooks/chat/omp/pending-sessions';
16
+ import type { PendingSessionEntry } from '@/client/hooks/chat/omp/pending-entry';
17
17
  import { listPendingSessions, patchPendingEntry } from '@/client/hooks/chat/omp/pending-sessions';
18
18
 
19
19
  export type PendingWait = NonNullable<PendingSessionEntry['waiting']>;
@@ -33,7 +33,7 @@
33
33
  * in `wait.e2e.ts` — the settle spec read `Wait Running` for 30s).
34
34
  */
35
35
 
36
- import { isSpawnAdoption } from '@/client/hooks/chat/omp/pending-sessions';
36
+ import { isSpawnAdoption } from '@/client/hooks/chat/omp/pending-adoption';
37
37
 
38
38
  export interface RunSwitchInput {
39
39
  /** The session id this hook last prepared its refs for, or null on mount. */
@@ -29,6 +29,7 @@ import { createContext } from 'preact/compat';
29
29
  import type { ReactNode } from 'preact/compat';
30
30
  import { useRealtimeTopic } from '@/client/hooks/ui/realtime';
31
31
  import { useInputRequiredAlert } from '@/client/hooks/ui/input-required-alert';
32
+ import { useRunOutcomeAlert } from '@/client/hooks/ui/run-outcome-alert';
32
33
 
33
34
  import { realtimeClient } from '@/shared/lib/realtime/client';
34
35
  import { TOPIC_SIDEBAR, TOPIC_SIDEBAR_ACTIVITY, TOPIC_SIDEBAR_STATUS } from '@/shared/lib/realtime/protocol';
@@ -206,6 +207,9 @@ export function SidebarDataProvider({ children, initialFolders = [] }: { childre
206
207
  // Fires for ANY session, including one this tab never opened — the cue that an
207
208
  // agent is blocked on an answer must not depend on the open timeline.
208
209
  useInputRequiredAlert(folders);
210
+ // The same list, for the terminal side of a run: a session that finished
211
+ // while the operator was reading another one is exactly what a banner is for.
212
+ useRunOutcomeAlert(folders);
209
213
 
210
214
  const markSeen = useCallback((sessionId: number | string) => {
211
215
  const key = String(sessionId);
@@ -0,0 +1,122 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The roster of subagents one session ran, as data.
8
+ *
9
+ * Split out of the list component that used to draw subagents: the tree now
10
+ * draws the rows, and it needs the same roster from the same two sources (the
11
+ * transcript history on disk, plus the live frames for the session that is
12
+ * open). Both passes are unchanged; only the consumer moved.
13
+ */
14
+
15
+ import { useEffect, useState } from 'preact/hooks';
16
+ import { isRecord } from '@/shared/lib/util/guards';
17
+ import { fetchSubagentHistory, historyEntryToSubagentInfo } from '@/shared/lib/omp/subagent/history/client';
18
+ import {
19
+ mergeSubagentRoster,
20
+ parseSubagentLifecycle,
21
+ parseSubagentRosterResponse,
22
+ readSubagentProgressFrame,
23
+ } from '@/shared/lib/omp/subagent/parse';
24
+ import { subscribeSubagentFrame, type SubagentFrame } from '@/shared/lib/chat/omp/subagent-frames';
25
+ import type { SubagentInfo, SubagentProgress } from '@/shared/types';
26
+
27
+ export interface SubagentRoster {
28
+ subagents: SubagentInfo[];
29
+ isLoading: boolean;
30
+ }
31
+
32
+ const PROGRESS_STATUS: Record<NonNullable<SubagentProgress['status']>, SubagentInfo['status']> = {
33
+ pending: 'started', running: 'started', completed: 'completed', failed: 'failed', aborted: 'aborted',
34
+ };
35
+
36
+ /** Fold one progress frame into the roster entry it names (id, else index). */
37
+ function applyProgress(roster: SubagentInfo[], progress: SubagentProgress): SubagentInfo[] {
38
+ return roster.map((entry) => {
39
+ if (progress.id !== undefined) {
40
+ if (entry.id !== progress.id) return entry;
41
+ } else if (progress.index === undefined || progress.index < 0 || entry.index !== progress.index) {
42
+ return entry;
43
+ }
44
+ const status = progress.status && entry.status === 'started'
45
+ ? PROGRESS_STATUS[progress.status] ?? entry.status
46
+ : entry.status;
47
+ return { ...entry, status, progress: { ...entry.progress, ...progress }, lastUpdate: Date.now() };
48
+ });
49
+ }
50
+
51
+ /**
52
+ * The roster for one session.
53
+ *
54
+ * `enabled` is the session's own `hasSubagents` flag: a branch opened for its
55
+ * CHILD SESSIONS must not fire a roster read (history request plus a
56
+ * `get_subagents` snapshot) that can only answer empty.
57
+ */
58
+ export function useSubagentRoster(
59
+ sessionId: string,
60
+ isActiveSession: boolean,
61
+ enabled: boolean,
62
+ ): SubagentRoster {
63
+ const [subagents, setSubagents] = useState<SubagentInfo[]>([]);
64
+ const [isLoading, setIsLoading] = useState(false);
65
+
66
+ useEffect(() => {
67
+ if (!enabled) return;
68
+ let cancelled = false;
69
+ setSubagents([]);
70
+ setIsLoading(true);
71
+ void fetchSubagentHistory(sessionId)
72
+ .then((entries) => {
73
+ if (cancelled || !entries) return;
74
+ const roster = entries.map(historyEntryToSubagentInfo);
75
+ setSubagents((prev) => mergeSubagentRoster(prev, roster));
76
+ })
77
+ .finally(() => { if (!cancelled) setIsLoading(false); });
78
+ return () => { cancelled = true; };
79
+ }, [sessionId, enabled]);
80
+
81
+ useEffect(() => {
82
+ if (!enabled || !isActiveSession) return;
83
+ let cancelled = false;
84
+ const requestedAt = Date.now();
85
+ const forThisSession = (frame: SubagentFrame) =>
86
+ frame.sessionId === sessionId ? frame.payload : null;
87
+
88
+ const unsubLifecycle = subscribeSubagentFrame('subagent_lifecycle', (frame) => {
89
+ const entry = parseSubagentLifecycle(forThisSession(frame));
90
+ if (entry) setSubagents((prev) => mergeSubagentRoster(prev, [entry]));
91
+ });
92
+ const unsubProgress = subscribeSubagentFrame('subagent_progress', (frame) => {
93
+ const progress = readSubagentProgressFrame(forThisSession(frame));
94
+ if (progress) setSubagents((prev) => applyProgress(prev, progress));
95
+ });
96
+
97
+ // Snapshot the LIVE registry. This POST is the spawn path, so the server
98
+ // refuses it (409) for a session it does not manage — an observer read must
99
+ // never boot an omp child. The history pass already covers a finished
100
+ // session from disk, so nothing is missing when this comes back empty.
101
+ fetch(`/api/agent/${encodeURIComponent(sessionId)}`, {
102
+ method: 'POST',
103
+ headers: { 'Content-Type': 'application/json' },
104
+ body: JSON.stringify({ type: 'get_subagents' }),
105
+ })
106
+ .then((res) => (res.ok ? res.json() : null))
107
+ .then((body: unknown) => {
108
+ if (cancelled || !isRecord(body)) return;
109
+ const payload = 'data' in body ? body.data : body;
110
+ setSubagents((prev) => mergeSubagentRoster(prev, parseSubagentRosterResponse(payload), requestedAt));
111
+ })
112
+ .catch(() => {});
113
+
114
+ return () => {
115
+ cancelled = true;
116
+ unsubLifecycle();
117
+ unsubProgress();
118
+ };
119
+ }, [enabled, isActiveSession, sessionId]);
120
+
121
+ return { subagents, isLoading };
122
+ }
@@ -0,0 +1,55 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What a pending child chat sends to `/api/sessions/spawn`.
8
+ *
9
+ * The fields are OMITTED when the composer has no value: the route inherits the
10
+ * parent's harness and model when they are absent, and sending `null`/`auto`
11
+ * would override that inheritance with a value the agent never asked for.
12
+ */
13
+
14
+ import { describe, expect, test } from 'bun:test';
15
+ import { childSpawnBody } from '@/client/hooks/chat/timeline/child-spawn';
16
+
17
+ describe('childSpawnBody', () => {
18
+ test('carries the parent, prompt and every pick the composer made', () => {
19
+ expect(
20
+ childSpawnBody('parent', 'review this', {
21
+ harness: 'claude',
22
+ model: { provider: 'acme', modelId: 'big' },
23
+ thinkingLevel: 'high',
24
+ accessMode: 'yolo',
25
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
26
+ }),
27
+ ).toEqual({
28
+ parentSessionId: 'parent',
29
+ prompt: 'review this',
30
+ harness: 'claude',
31
+ model: { provider: 'acme', modelId: 'big' },
32
+ thinkingLevel: 'high',
33
+ accessMode: 'yolo',
34
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
35
+ });
36
+ });
37
+
38
+ test('leaves unknown picks out so the server inherits them', () => {
39
+ const body = childSpawnBody('parent', 'go', {
40
+ harness: null,
41
+ model: null,
42
+ thinkingLevel: 'auto',
43
+ accessMode: null,
44
+ images: [],
45
+ });
46
+ expect(body).toEqual({ parentSessionId: 'parent', prompt: 'go' });
47
+ });
48
+
49
+ test('a half-named model is not sent', () => {
50
+ const body = childSpawnBody('parent', 'go', {
51
+ model: { provider: 'acme', modelId: '' },
52
+ });
53
+ expect(body).not.toHaveProperty('model');
54
+ });
55
+ });
@@ -0,0 +1,45 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * The body of `POST /api/sessions/spawn` for a pending child chat.
8
+ *
9
+ * Split out so the payload rule can be asserted without mounting the composer:
10
+ * every field the composer does not actually have a value for must be OMITTED,
11
+ * never sent as `null` — the route treats an absent harness as "inherit the
12
+ * parent's", and an absent model as "use the parent/project default".
13
+ */
14
+
15
+ import type { AgentImage } from '@/shared/types';
16
+ import type { ApprovalMode } from '@/shared/lib/omp/config/access-mode';
17
+
18
+ export interface ChildSpawnPicks {
19
+ harness?: string | null;
20
+ model?: { provider: string; modelId: string } | null;
21
+ thinkingLevel?: string | null;
22
+ accessMode?: ApprovalMode | null;
23
+ images?: AgentImage[] | null;
24
+ }
25
+
26
+ export function childSpawnBody(
27
+ parentSessionId: string,
28
+ prompt: string,
29
+ picks: ChildSpawnPicks = {},
30
+ ): Record<string, unknown> {
31
+ const model = picks.model;
32
+ return {
33
+ parentSessionId,
34
+ prompt,
35
+ ...(picks.harness ? { harness: picks.harness } : {}),
36
+ ...(model?.provider && model.modelId ? { model } : {}),
37
+ // `auto` means "leave the agent's own level alone"; sending it would move a
38
+ // configured level to a literal the ACP handshake may not accept.
39
+ ...(picks.thinkingLevel && picks.thinkingLevel !== 'auto'
40
+ ? { thinkingLevel: picks.thinkingLevel }
41
+ : {}),
42
+ ...(picks.accessMode ? { accessMode: picks.accessMode } : {}),
43
+ ...(picks.images?.length ? { images: picks.images } : {}),
44
+ };
45
+ }
@@ -0,0 +1,54 @@
1
+ /**
2
+ * @license
3
+ * SPDX-License-Identifier: MIT
4
+ */
5
+
6
+ /**
7
+ * What the fork composer sends to `/api/sessions/:id/fork`.
8
+ *
9
+ * Omitted fields let the fork keep the source's own model/thinking level and
10
+ * an absent message lets it branch without a first turn — both are normal.
11
+ */
12
+
13
+ import { describe, expect, test } from 'bun:test';
14
+ import { forkRequestBody } from '@/client/hooks/chat/timeline/fork-request';
15
+
16
+ describe('forkRequestBody', () => {
17
+ test('carries the anchor and every pick the composer made', () => {
18
+ expect(
19
+ forkRequestBody('u2', {
20
+ prompt: 'try another angle',
21
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
22
+ model: { provider: 'acme', modelId: 'big' },
23
+ thinkingLevel: 'high',
24
+ accessMode: 'write',
25
+ }),
26
+ ).toEqual({
27
+ anchorEntryId: 'u2',
28
+ prompt: 'try another angle',
29
+ images: [{ type: 'image', data: 'aGk=', mimeType: 'image/png' }],
30
+ model: { provider: 'acme', modelId: 'big' },
31
+ thinkingLevel: 'high',
32
+ accessMode: 'write',
33
+ });
34
+ });
35
+
36
+ test('a bare fork sends only the anchor', () => {
37
+ expect(forkRequestBody('a2')).toEqual({ anchorEntryId: 'a2' });
38
+ expect(
39
+ forkRequestBody('a2', {
40
+ prompt: ' ',
41
+ images: [],
42
+ model: null,
43
+ thinkingLevel: 'auto',
44
+ accessMode: null,
45
+ }),
46
+ ).toEqual({ anchorEntryId: 'a2' });
47
+ });
48
+
49
+ test('a half-named model is not sent', () => {
50
+ expect(forkRequestBody('u1', { model: { provider: '', modelId: 'x' } })).toEqual({
51
+ anchorEntryId: 'u1',
52
+ });
53
+ });
54
+ });