@adecore/agents-react 0.40.3 → 0.40.4

package/dist/chat/chat-client.js

@@ -398,7 +398,8 @@ export class ChatClient {
       const page = result.history === undefined ? undefined : {
         history: result.history,
         pending: result.pending ?? [],
-        subagents: result.subagents ?? []
+        subagents: result.subagents ?? [],
+        outline: result.outline ?? []
       };
       this.sink.reset(chatId, result.info, result.items, page);
     }

package/dist/chat/logic/scrubber.d.ts

@@ -1,5 +1,5 @@
-import type { ChatBookmark } from '@adecore/agent-contracts';
-import type { TimelineRow } from './timeline.js';
+import type { ChatBookmark, ChatItem } from '@adecore/agent-contracts';
+import { type TimelineRow } from './timeline.js';
 export type TickKind = 'person' | 'wake' | 'bookmark';
 export interface ScrubberTick {
     id: string;
@@ -15,7 +15,8 @@ export declare const TICK_HEIGHT_PX = 2;
 export declare const STRIP_WIDTH_PX = 24;
 export declare const STRIP_INSET_PX = 8;
 export declare const STRIP_CLEARANCE_PX: number;
-export declare function ticksOf(rows: readonly TimelineRow[], marks?: ReadonlyMap<string, ChatBookmark>): ScrubberTick[];
+export declare const EARLIER_ROW = -1;
+export declare function ticksOf(rows: readonly TimelineRow[], marks?: ReadonlyMap<string, ChatBookmark>, earlier?: readonly ChatItem[], bookmarks?: readonly ChatBookmark[]): ScrubberTick[];
 export interface TickSlot {
     first: number;
     last: number;

package/dist/chat/logic/scrubber.js

@@ -1,3 +1,4 @@
+import { agentTurnLabel } from './timeline.js';
 import { DEFAULT_READING_WIDTH, readingMeasure } from '../reading-width.js';
 /* With fewer messages than this the thread is short enough to scroll through, and the strip is noise. */
 export const SCRUBBER_MIN_TICKS = 3;
@@ -15,9 +16,56 @@ const WIDTH_NEAR_PERSON_PX = 12;
 const WIDTH_NEAR_WAKE_PX = 8;
 const WIDTH_PERSON_PX = 8;
 const WIDTH_WAKE_PX = 5;
-/* `marks` is what `bookmarkRows` answers: the bookmark drawn at a row, by row id. */
-export function ticksOf(rows, marks = new Map()) {
-  return rows.flatMap((row, rowIndex) => {
+/* Below every row, so a tick before the rows this client holds sorts first and its stretch reaches the first row of the thread. */
+export const EARLIER_ROW = -1;
+/* A message before the rows this client holds, as the outline (`outlineItems`) has it; its row id is the one the thread will draw it with. */
+function earlierTick(item, bookmarks) {
+  const bookmark = bookmarks.get(item.id) ?? null;
+  const rowIndex = EARLIER_ROW;
+  if (item.kind === 'user') {
+    const text = item.text !== '' ? item.text : (item.attachments ?? []).map(attachment => attachment.name).join(', ');
+    return {
+      id: item.id,
+      rowIndex,
+      kind: 'person',
+      text,
+      createdAt: item.createdAt,
+      turnId: item.turnId,
+      bookmark
+    };
+  }
+  if (item.kind === 'turn' && ((item.taskIds?.length ?? 0) > 0 || (item.messageFrom?.length ?? 0) > 0)) {
+    return {
+      id: `start-${item.id}`,
+      rowIndex,
+      kind: 'wake',
+      text: agentTurnLabel(item),
+      createdAt: item.createdAt,
+      turnId: item.id,
+      bookmark: null
+    };
+  }
+  if (item.kind === 'assistant' && bookmark !== null) {
+    return {
+      id: item.id,
+      rowIndex,
+      kind: 'bookmark',
+      text: item.text,
+      createdAt: item.createdAt,
+      turnId: item.turnId,
+      bookmark
+    };
+  }
+  return null;
+}
+/*
+ * `marks` is what `bookmarkRows` answers: the bookmark drawn at a row, by row id. `earlier` is the
+ * outline of the thread before `rows`, and `bookmarks` the chat's, which mark the ticks of that part.
+ */
+export function ticksOf(rows, marks = new Map(), earlier = [], bookmarks = []) {
+  const byItem = new Map(bookmarks.map(bookmark => [bookmark.itemId, bookmark]));
+  const before = earlier.flatMap(item => earlierTick(item, byItem) ?? []);
+  const held = rows.flatMap((row, rowIndex) => {
     const bookmark = marks.get(row.id) ?? null;
     if (row.kind === 'user') {
       // A message of only attachments still has a place in the thread; its names stand in for the text.
@@ -70,6 +118,7 @@ export function ticksOf(rows, marks = new Map()) {
       bookmark
     }];
   });
+  return before.length === 0 ? held : [...before, ...held];
 }
 /* `marked` and `found` say per message whether it has a bookmark and whether a find hit falls under it; absent, none has. */
 export function layoutTicks(kinds, height, marked = [], found = []) {

package/dist/chat/ui/Timeline.js

@@ -13,7 +13,7 @@ import { registerItemJumper, registerMessageStepper, registerTimeline, registerT
 import { useTimelineFlash } from '../timeline-flash.js';
 import { useChatPreferences } from '../preferences.js';
 import { readingMeasure, readingWidthStyle } from '../reading-width.js';
-import { SCRUBBER_MIN_TICKS, STRIP_INSET_PX, STRIP_WIDTH_PX, messagesInView, stepMessage, threadPaddingLeft, STRIP_CLEARANCE_PX, tickOfRow, ticksOf, ticksWithHits } from '../logic/scrubber.js';
+import { SCRUBBER_MIN_TICKS, STRIP_INSET_PX, STRIP_WIDTH_PX, messagesInView, stepMessage, threadPaddingLeft, STRIP_CLEARANCE_PX, tickOfRow, ticksOf, ticksWithHits, EARLIER_ROW } from '../logic/scrubber.js';
 import { EMPTY_TARGET, readTimelineTarget, revealUiReplyBlock, uiReplyJump, withCurrentText } from '../logic/timeline-target.js';
 import { forkRefusal } from '../logic/fork.js';
 import { UiReplyNavigationContext } from './reply-context.js';
@@ -410,11 +410,12 @@ export function Timeline({
   const items = useChatRow(chatId, row_0 => row_0?.structure);
   const activeTurnId = useChatRow(chatId, row_1 => row_1?.info.activeTurnId ?? null);
   const bookmarks = useChatRow(chatId, row_2 => row_2?.bookmarks);
-  const visuals = useChatRow(chatId, row_3 => row_3?.visuals);
+  const outlineBefore = useChatRow(chatId, row_3 => row_3?.outlineBefore);
+  const visuals = useChatRow(chatId, row_4 => row_4?.visuals);
   const forkedTurns = useForkedTurns(chatId);
-  const info = useChatRow(chatId, row_4 => row_4?.info ?? null);
-  const historyPending = useChatRow(chatId, row_5 => row_5?.historyPending === true);
-  const cursor = useChatRow(chatId, row_6 => row_6?.history?.cursor ?? null);
+  const info = useChatRow(chatId, row_5 => row_5?.info ?? null);
+  const historyPending = useChatRow(chatId, row_6 => row_6?.historyPending === true);
+  const cursor = useChatRow(chatId, row_7 => row_7?.history?.cursor ?? null);
   const scope = useChatScope();
   const {
     id: scopeId,
@@ -499,7 +500,7 @@ export function Timeline({
   // A chat that took a turn before is one whose thread has not come in yet, not one to greet.
   const welcome = !loadingHistory && welcomes && empty && (info === null || info.usage.turns === 0 && info.activeTurnId === null);
   const marks = useMemo(() => bookmarkRows(rows, bookmarks ?? [], items ?? {}), [rows, bookmarks, items]);
-  const ticks = useMemo(() => ticksOf(rows, marks), [rows, marks]);
+  const ticks = useMemo(() => ticksOf(rows, marks, outlineBefore, bookmarks), [rows, marks, outlineBefore, bookmarks]);
   // A message a jump is on its way to; it may first have to open the turn its reply folded into.
   const [seeking, setSeeking] = useState(null);
   const [landing, setLanding] = useState(null);
@@ -601,7 +602,7 @@ export function Timeline({
     }
     // Ref measurements can change offsets after render. Commit those offsets before the first paint.
     const measured = virtualizer.getVirtualItems();
-    if (virtualRows.length !== measured.length || virtualRows.some((row_7, index_1) => row_7.key !== measured[index_1]?.key || row_7.start !== measured[index_1]?.start || row_7.size !== measured[index_1]?.size)) {
+    if (virtualRows.length !== measured.length || virtualRows.some((row_8, index_1) => row_8.key !== measured[index_1]?.key || row_8.start !== measured[index_1]?.start || row_8.size !== measured[index_1]?.size)) {
       settleLayout();
       return;
     }
@@ -640,16 +641,16 @@ export function Timeline({
       return;
     }
     const anchor = anchorRef.current;
-    const index_2 = moved && anchor !== null && !followRef.current ? rows.findIndex(row_8 => row_8.id === anchor.id) : -1;
+    const index_2 = moved && anchor !== null && !followRef.current ? rows.findIndex(row_9 => row_9.id === anchor.id) : -1;
     if (anchor !== null && index_2 !== -1) {
       virtualizer.getTotalSize();
       element_3.scrollTop = virtualizer.measurementsCache[index_2].start - anchor.offset;
       return;
     }
-    const row_9 = virtualizer.getVirtualItemForOffset(element_3.scrollTop);
-    anchorRef.current = row_9 === undefined ? null : {
-      id: String(row_9.key),
-      offset: row_9.start - element_3.scrollTop
+    const row_10 = virtualizer.getVirtualItemForOffset(element_3.scrollTop);
+    anchorRef.current = row_10 === undefined ? null : {
+      id: String(row_10.key),
+      offset: row_10.start - element_3.scrollTop
     };
   });
   // Close to the top, the page before goes in; again after each page that left too little above the reader.
@@ -759,10 +760,11 @@ export function Timeline({
     if (!tick_0) {
       return;
     }
-    if (tick_0.bookmark !== null) {
+    // A message before the rows this client holds comes in page by page until its row is there.
+    if (tick_0.bookmark !== null || tick_0.rowIndex === EARLIER_ROW) {
       setLanding(null);
       setSeeking({
-        itemId: tick_0.bookmark.itemId,
+        itemId: tick_0.bookmark?.itemId ?? tick_0.id,
         key: keyOf(chatId)
       });
       return;
@@ -798,7 +800,7 @@ export function Timeline({
       }
       return;
     }
-    const index_6 = rows.findIndex(row_10 => row_10.id === seeking.itemId);
+    const index_6 = rows.findIndex(row_11 => row_11.id === seeking.itemId);
     if (index_6 !== -1) {
       setSeeking(null);
       showRowAtTop(virtualizer, followRef, index_6);
@@ -872,9 +874,9 @@ export function Timeline({
       turnId: turnId_0,
       target: target_0
     } = revealing;
-    const changes = target_0 === 'changes' ? rows.findIndex(row_11 => row_11.kind === 'changed-files' && row_11.turnId === turnId_0) : -1;
+    const changes = target_0 === 'changes' ? rows.findIndex(row_12 => row_12.kind === 'changed-files' && row_12.turnId === turnId_0) : -1;
     const opening = order?.map(id_0 => items?.[id_0]).find(item_0 => item_0?.kind === 'user' && item_0.turnId === turnId_0);
-    const found_0 = changes !== -1 ? changes : rows.findIndex(row_12 => row_12.id === opening?.id || row_12.id === `start-${turnId_0}` || row_12.id === `fold-${turnId_0}`);
+    const found_0 = changes !== -1 ? changes : rows.findIndex(row_13 => row_13.id === opening?.id || row_13.id === `start-${turnId_0}` || row_13.id === `fold-${turnId_0}`);
     if (found_0 !== -1) {
       setRevealing(null);
       showRowAtTop(virtualizer, followRef, found_0);
@@ -903,8 +905,8 @@ export function Timeline({
       if (fork === null) {
         return false;
       }
-      const row_13 = useChats.getState().byKey[keyOf(chatId)];
-      return forkRefusal(row_13?.info ?? null, row_13?.structure[turnId_2]) === null;
+      const row_14 = useChats.getState().byKey[keyOf(chatId)];
+      return forkRefusal(row_14?.info ?? null, row_14?.structure[turnId_2]) === null;
     },
     fork: turnId_3 => fork?.(chatId, turnId_3)
   }), [keyOf, chatId, fork]);
@@ -1028,22 +1030,22 @@ export function Timeline({
                     children: /*#__PURE__*/_jsx(FindRevealContext.Provider, {
                       value: chatFind.reveal,
                       children: virtualRows.map(virtualRow_1 => {
-                        const row_14 = rows[virtualRow_1.index];
+                        const row_15 = rows[virtualRow_1.index];
                         return /*#__PURE__*/_jsx(ThreadRow, {
-                          row: row_14,
+                          row: row_15,
                           previous: virtualRow_1.index > 0 ? rows[virtualRow_1.index - 1] : null,
                           index: virtualRow_1.index,
                           top: virtualRow_1.start,
                           measure: virtualizer.measureElement,
                           chatId: chatId,
-                          flashNonce: flash !== null && flashedRow === row_14.id ? flash.nonce : null,
-                          bookmark: marks.get(row_14.id) ?? null,
+                          flashNonce: flash !== null && flashedRow === row_15.id ? flash.nonce : null,
+                          bookmark: marks.get(row_15.id) ?? null,
                           toggleGroup: groups.toggle,
                           toggleTurn: turns.toggle,
                           toggleSubagent: subagents.toggle,
                           openSubagent: openSubagent,
                           openConversation: openConversation
-                        }, row_14.id);
+                        }, row_15.id);
                       })
                     })
                   })

package/dist/state/chats.d.ts

@@ -8,6 +8,7 @@ export interface ChatState {
     history?: ChatHistoryPage;
     waitingBefore?: string[];
     subagentsBefore?: string[];
+    outlineBefore?: ChatItem[];
     bookmarks?: ChatBookmark[];
     visuals?: ChatVisual[];
 }
@@ -16,6 +17,7 @@ export interface ChatPage {
     history: ChatHistoryPage;
     pending: ChatItem[];
     subagents?: ChatSubagentItem[];
+    outline?: ChatItem[];
 }
 export type ChatsById = Record<string, ChatState>;
 export type ChatStatuses = Record<string, Pick<ChatState, 'info'>>;

package/dist/state/chats.js

@@ -29,7 +29,8 @@ function stateOf(info, items, page) {
     order,
     history: page.history,
     waitingBefore: before.map(item => item.id),
-    subagentsBefore: subagents.map(item => item.id)
+    subagentsBefore: subagents.map(item => item.id),
+    outlineBefore: (page.outline ?? []).filter(item => !(item.id in byId))
   };
 }
 /* An older host names no place in the thread, and it always hands over the whole of it. */
@@ -83,6 +84,7 @@ export function prependPage(state, cursor, page) {
       history: _history,
       waitingBefore: _waitingBefore,
       subagentsBefore: _subagentsBefore,
+      outlineBefore: _outlineBefore,
       ...rest
     } = loaded;
     return {
@@ -94,6 +96,7 @@ export function prependPage(state, cursor, page) {
   }
   const waitingBefore = (state.waitingBefore ?? []).filter(id => !olderIds.has(id));
   const subagentsBefore = (state.subagentsBefore ?? []).filter(id => !olderIds.has(id));
+  const outlineBefore = (state.outlineBefore ?? []).filter(item => !olderIds.has(item.id));
   return {
     ...loaded,
     items,
@@ -101,7 +104,8 @@ export function prependPage(state, cursor, page) {
     order,
     history: page.history,
     waitingBefore,
-    subagentsBefore
+    subagentsBefore,
+    outlineBefore
   };
 }
 /* The requests that still wait, oldest first: those from before the page this client holds, then the thread's own. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adecore/agents-react",
-  "version": "0.40.3",
+  "version": "0.40.4",
   "description": "React agent chat threads, composers, approvals, provider accounts and usage views.",
   "type": "module",
   "exports": {
@@ -67,11 +67,11 @@
     "test:visuals": "bun --config=integration.bunfig.toml --conditions=source test ./src/chat/visual-viewport.integration.test.ts"
   },
   "dependencies": {
-    "@adecore/agent-contracts": "0.40.3",
-    "@adecore/editor": "0.40.3",
-    "@adecore/editor-react": "0.40.3",
-    "@adecore/intelligent-ui": "0.40.3",
-    "@adecore/merge": "0.40.3",
+    "@adecore/agent-contracts": "0.40.4",
+    "@adecore/editor": "0.40.4",
+    "@adecore/editor-react": "0.40.4",
+    "@adecore/intelligent-ui": "0.40.4",
+    "@adecore/merge": "0.40.4",
     "@codemirror/commands": "^6.11.1",
     "@codemirror/language": "^6.13.1",
     "@codemirror/state": "^6.7.6",
@@ -94,14 +94,14 @@
     "zustand": "^5.0.16"
   },
   "peerDependencies": {
-    "@adecore/ui": "^0.40.3",
+    "@adecore/ui": "^0.40.4",
     "i18next": "^26.4.2",
     "react": "^19.3.0",
     "react-dom": "^19.3.0",
     "react-i18next": "^17.0.15"
   },
   "devDependencies": {
-    "@adecore/ui": "0.40.3",
+    "@adecore/ui": "0.40.4",
     "@types/bun": "^1.4.4",
     "@types/react": "^19.3.0",
     "@types/react-dom": "^19.3.0",

package/src/chat/chat-client.ts

@@ -443,7 +443,9 @@ export class ChatClient {
             }
         } else {
             const page =
-                result.history === undefined ? undefined : { history: result.history, pending: result.pending ?? [], subagents: result.subagents ?? [] };
+                result.history === undefined
+                    ? undefined
+                    : { history: result.history, pending: result.pending ?? [], subagents: result.subagents ?? [], outline: result.outline ?? [] };
 
             this.sink.reset(chatId, result.info, result.items, page);
         }

package/src/chat/logic/scrubber.ts

@@ -1,5 +1,5 @@
-import type { ChatBookmark } from '@adecore/agent-contracts';
-import type { TimelineRow } from './timeline';
+import type { ChatBookmark, ChatItem } from '@adecore/agent-contracts';
+import { agentTurnLabel, type TimelineRow } from './timeline';
 import { DEFAULT_READING_WIDTH, readingMeasure } from '../reading-width';
 
 // The strip of ticks at the left edge of a chat view, as numbers; the component only draws what comes out of here.
@@ -9,7 +9,7 @@ export type TickKind = 'person' | 'wake' | 'bookmark';
 
 export interface ScrubberTick {
     id: string;
-    /* The row of the timeline the tick jumps to. */
+    /* The row of the timeline the tick jumps to; `EARLIER_ROW` for a message before the part of the thread this client holds. */
     rowIndex: number;
     kind: TickKind;
     text: string;
@@ -41,9 +41,45 @@ const WIDTH_NEAR_WAKE_PX = 8;
 const WIDTH_PERSON_PX = 8;
 const WIDTH_WAKE_PX = 5;
 
-/* `marks` is what `bookmarkRows` answers: the bookmark drawn at a row, by row id. */
-export function ticksOf(rows: readonly TimelineRow[], marks: ReadonlyMap<string, ChatBookmark> = new Map()): ScrubberTick[] {
-    return rows.flatMap((row, rowIndex): ScrubberTick[] => {
+/* Below every row, so a tick before the rows this client holds sorts first and its stretch reaches the first row of the thread. */
+export const EARLIER_ROW = -1;
+
+/* A message before the rows this client holds, as the outline (`outlineItems`) has it; its row id is the one the thread will draw it with. */
+function earlierTick(item: ChatItem, bookmarks: ReadonlyMap<string, ChatBookmark>): ScrubberTick | null {
+    const bookmark = bookmarks.get(item.id) ?? null;
+    const rowIndex = EARLIER_ROW;
+
+    if (item.kind === 'user') {
+        const text = item.text !== '' ? item.text : (item.attachments ?? []).map((attachment) => attachment.name).join(', ');
+
+        return { id: item.id, rowIndex, kind: 'person', text, createdAt: item.createdAt, turnId: item.turnId, bookmark };
+    }
+
+    if (item.kind === 'turn' && ((item.taskIds?.length ?? 0) > 0 || (item.messageFrom?.length ?? 0) > 0)) {
+        return { id: `start-${item.id}`, rowIndex, kind: 'wake', text: agentTurnLabel(item), createdAt: item.createdAt, turnId: item.id, bookmark: null };
+    }
+
+    if (item.kind === 'assistant' && bookmark !== null) {
+        return { id: item.id, rowIndex, kind: 'bookmark', text: item.text, createdAt: item.createdAt, turnId: item.turnId, bookmark };
+    }
+
+    return null;
+}
+
+/*
+ * `marks` is what `bookmarkRows` answers: the bookmark drawn at a row, by row id. `earlier` is the
+ * outline of the thread before `rows`, and `bookmarks` the chat's, which mark the ticks of that part.
+ */
+export function ticksOf(
+    rows: readonly TimelineRow[],
+    marks: ReadonlyMap<string, ChatBookmark> = new Map(),
+    earlier: readonly ChatItem[] = [],
+    bookmarks: readonly ChatBookmark[] = []
+): ScrubberTick[] {
+    const byItem = new Map(bookmarks.map((bookmark) => [bookmark.itemId, bookmark]));
+    const before = earlier.flatMap((item) => earlierTick(item, byItem) ?? []);
+
+    const held = rows.flatMap((row, rowIndex): ScrubberTick[] => {
         const bookmark = marks.get(row.id) ?? null;
 
         if (row.kind === 'user') {
@@ -71,6 +107,8 @@ export function ticksOf(rows: readonly TimelineRow[], marks: ReadonlyMap<string,
 
         return [{ id: row.id, rowIndex, kind: 'bookmark', text: bookmark.excerpt, createdAt: bookmark.createdAt, turnId, bookmark }];
     });
+
+    return before.length === 0 ? held : [...before, ...held];
 }
 
 /* One drawn tick: a message, or a run of messages merged once the height has fewer pixels than they need. */

package/src/chat/ui/Timeline.tsx

@@ -45,7 +45,8 @@ import {
     STRIP_CLEARANCE_PX,
     tickOfRow,
     ticksOf,
-    ticksWithHits
+    ticksWithHits,
+    EARLIER_ROW
 } from '../logic/scrubber';
 import {
     EMPTY_TARGET,
@@ -206,6 +207,7 @@ export function Timeline({
     const items = useChatRow(chatId, (row) => row?.structure);
     const activeTurnId = useChatRow(chatId, (row) => row?.info.activeTurnId ?? null);
     const bookmarks = useChatRow(chatId, (row) => row?.bookmarks);
+    const outlineBefore = useChatRow(chatId, (row) => row?.outlineBefore);
     const visuals = useChatRow(chatId, (row) => row?.visuals);
     const forkedTurns = useForkedTurns(chatId);
     const info = useChatRow(chatId, (row) => row?.info ?? null);
@@ -306,7 +308,7 @@ export function Timeline({
     // A chat that took a turn before is one whose thread has not come in yet, not one to greet.
     const welcome = !loadingHistory && welcomes && empty && (info === null || (info.usage.turns === 0 && info.activeTurnId === null));
     const marks = useMemo(() => bookmarkRows(rows, bookmarks ?? [], items ?? {}), [rows, bookmarks, items]);
-    const ticks = useMemo(() => ticksOf(rows, marks), [rows, marks]);
+    const ticks = useMemo(() => ticksOf(rows, marks, outlineBefore, bookmarks), [rows, marks, outlineBefore, bookmarks]);
     // A message a jump is on its way to; it may first have to open the turn its reply folded into.
     const [seeking, setSeeking] = useState<{ itemId: string; block?: UiReplyTarget; key: string; options?: ItemJumpOptions } | null>(null);
     const [landing, setLanding] = useState<{ target: UiReplyTarget; key: string } | null>(null);
@@ -613,9 +615,10 @@ export function Timeline({
             return;
         }
 
-        if (tick.bookmark !== null) {
+        // A message before the rows this client holds comes in page by page until its row is there.
+        if (tick.bookmark !== null || tick.rowIndex === EARLIER_ROW) {
             setLanding(null);
-            setSeeking({ itemId: tick.bookmark.itemId, key: keyOf(chatId) });
+            setSeeking({ itemId: tick.bookmark?.itemId ?? tick.id, key: keyOf(chatId) });
 
             return;
         }

package/src/state/chats.ts

@@ -38,6 +38,11 @@ export interface ChatState {
      * that a message woke again without a scroll reaching back to its row.
      */
     subagentsBefore?: string[];
+    /*
+     * The outline of the thread before that part (`outlineItems`), cut down and kept apart from
+     * `items`, so the scrubber has a tick for every message before a scroll reaches it.
+     */
+    outlineBefore?: ChatItem[];
     /* The messages marked to come back to, as the host last said; absent until it said anything. */
     bookmarks?: ChatBookmark[];
     /* The pages agents published in the chat, as the host last said; absent until it said anything. */
@@ -53,6 +58,8 @@ export interface ChatPage {
     pending: ChatItem[];
     /* The active sub-agents from before the page; absent from a host that sends none. */
     subagents?: ChatSubagentItem[];
+    /* The outline of the thread before the page; absent from a host that sends none. */
+    outline?: ChatItem[];
 }
 
 /* Rows keyed with the scope's `keyOf`, so a thread says which host it runs on. */
@@ -124,7 +131,8 @@ function stateOf(info: ChatInfo, items: ChatItem[], page?: ChatPage): ChatState
         order,
         history: page.history,
         waitingBefore: before.map((item) => item.id),
-        subagentsBefore: subagents.map((item) => item.id)
+        subagentsBefore: subagents.map((item) => item.id),
+        outlineBefore: (page.outline ?? []).filter((item) => !(item.id in byId))
     };
 }
 
@@ -173,15 +181,16 @@ export function prependPage(state: ChatState, cursor: string, page: ChatHistoryR
     const order = [...olderIds, ...state.order];
 
     if (page.history.cursor === null) {
-        const { history: _history, waitingBefore: _waitingBefore, subagentsBefore: _subagentsBefore, ...rest } = loaded;
+        const { history: _history, waitingBefore: _waitingBefore, subagentsBefore: _subagentsBefore, outlineBefore: _outlineBefore, ...rest } = loaded;
 
         return { ...rest, items, structure: items, order };
     }
 
     const waitingBefore = (state.waitingBefore ?? []).filter((id) => !olderIds.has(id));
     const subagentsBefore = (state.subagentsBefore ?? []).filter((id) => !olderIds.has(id));
+    const outlineBefore = (state.outlineBefore ?? []).filter((item) => !olderIds.has(item.id));
 
-    return { ...loaded, items, structure: items, order, history: page.history, waitingBefore, subagentsBefore };
+    return { ...loaded, items, structure: items, order, history: page.history, waitingBefore, subagentsBefore, outlineBefore };
 }
 
 /* The requests that still wait, oldest first: those from before the page this client holds, then the thread's own. */