@north-light/crouter 0.3.200 → 0.3.201

package/dist/api/client.d.ts

@@ -1,6 +1,6 @@
 import type { DaemonRestartDTO, HealthDTO, StatusDTO } from './dto/health.js';
 import type { BashJobStatusDTO, BashJobStopResultDTO } from './dto/bash-jobs.js';
-import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeSessionDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
+import type { ArtifactListDTO, ArtifactsQuery, ContextListDTO, CreateNodeRequest, ListNodesQuery, NodeDetailDTO, NodeMessagesPageDTO, NodeMessagesQuery, NodeSessionDTO, NodeSnapshotDTO, NodeSummaryDTO, TranscriptDTO, TranscriptQuery } from './dto/nodes.js';
 import type { InterruptResultDTO, MessageResultDTO, SendMessageRequest } from './dto/messages.js';
 import type { PushReportRequest, PushReportResultDTO, ReportDTO, ReportsQuery } from './dto/reports.js';
 import type { CloseRequest, CloseResultDTO, PromoteRequest, RelaunchRootResultDTO, ReviveRequest, ReviveResultDTO, WaitRequest, YieldRequest } from './dto/lifecycle.js';
@@ -143,6 +143,7 @@ export declare class CrtrClient {
     getReports(id: string, q?: ReportsQuery): Promise<ReportDTO[]>;
     getTranscript(id: string, q?: TranscriptQuery): Promise<TranscriptDTO>;
     getSnapshot(id: string): Promise<NodeSnapshotDTO>;
+    getNodeMessages(id: string, q?: NodeMessagesQuery): Promise<NodeMessagesPageDTO>;
     /** The node's conversation exactly as it ran — raw `.jsonl` bytes plus the
      *  assembled system prompt. For exports; `getSnapshot` is for renderers. */
     getSession(id: string): Promise<NodeSessionDTO>;

package/dist/api/client.js

@@ -253,6 +253,9 @@ export class CrtrClient {
     getSnapshot(id) {
         return this.request('GET', routes.nodeSnapshot(this.nodePath(id)));
     }
+    getNodeMessages(id, q) {
+        return this.request('GET', withQuery(routes.nodeMessages(this.nodePath(id)), q));
+    }
     /** The node's conversation exactly as it ran — raw `.jsonl` bytes plus the
      *  assembled system prompt. For exports; `getSnapshot` is for renderers. */
     getSession(id) {

package/dist/api/dto/inbox.d.ts

@@ -30,7 +30,7 @@ export interface PageTicketSummaryDTO {
     source: TicketSourceDTO;
     slot_kinds: string[];
     awaits_response: boolean;
-    state?: 'pending' | 'resolved' | 'canceled' | 'passive';
+    state: 'pending' | 'resolved' | 'canceled' | 'passive';
     /** Present only on resolved history entries; the stored one-line answer digest. */
     answer_digest?: string;
 }

package/dist/api/dto/nodes.d.ts

@@ -175,6 +175,22 @@ export interface NodeSnapshotDTO {
     }[];
     captured_at: IsoTime;
 }
+/** `GET /v1/nodes/{id}/messages` query. `cursor` walks backward from the
+ * newest messages; each returned page remains chronological. */
+export interface NodeMessagesQuery {
+    cursor?: Cursor;
+    limit?: number;
+}
+/** `GET /v1/nodes/{id}/messages` — a backward-paged window over the node's
+ * cycle-flattened visible history. */
+export interface NodeMessagesPageDTO {
+    node_id: NodeIdDTO;
+    /** pi AgentMessage[] JSON, chronological ascending within this page. */
+    messages: unknown[];
+    /** Opaque cursor toward older messages; null at the start of the session. */
+    next_cursor: Cursor | null;
+    captured_at: IsoTime;
+}
 /** `GET /v1/nodes/{id}/session` — the node's conversation exactly as it ran:
  *  the raw session `.jsonl` bytes plus the assembled system prompt. Unlike
  *  `NodeSnapshotDTO` nothing is reconstructed or flattened, so every

package/dist/clients/attach/ansi-cells.d.ts

@@ -24,8 +24,17 @@ export declare function rowCells(line: string): number;
 /** Plain text of cells `[from, to)` — every escape, link boundary, and cursor
  *  marker dropped, exactly what a terminal copies out of that span. */
 export declare function sliceCells(line: string, from: number, to: number): string;
-/** Reverse-video cells `[from, to)`, re-asserting inverse after any SGR inside
- *  the span (a reset there would otherwise drop the highlight mid-selection).
- *  A short row is padded with spaces so a multi-row selection reads as one
- *  block, never past `maxCells`. */
+/** The SGR pair `styleCells` asserts over a span. */
+export type CellStyle = {
+    on: string;
+    off: string;
+};
+export declare const INVERSE_STYLE: CellStyle;
+/** Style cells `[from, to)`, re-asserting `style.on` after any SGR inside the
+ *  span (a reset there would otherwise drop the styling mid-span). A short row
+ *  is padded with spaces so a multi-row span reads as one block, never past
+ *  `maxCells`. Escapes are non-printing, so passes compose: styling an already
+ *  styled row leaves every cell position unmoved. */
+export declare function styleCells(line: string, from: number, to: number, maxCells: number, style?: CellStyle): string;
+/** Reverse-video cells `[from, to)` — the drag-selection highlight. */
 export declare function highlightCells(line: string, from: number, to: number, maxCells: number): string;

package/dist/clients/attach/ansi-cells.js

@@ -77,22 +77,24 @@ export function sliceCells(line, from, to) {
     });
     return text;
 }
-/** Reverse-video cells `[from, to)`, re-asserting inverse after any SGR inside
- *  the span (a reset there would otherwise drop the highlight mid-selection).
- *  A short row is padded with spaces so a multi-row selection reads as one
- *  block, never past `maxCells`. */
-export function highlightCells(line, from, to, maxCells) {
+export const INVERSE_STYLE = { on: INVERSE_ON, off: INVERSE_OFF };
+/** Style cells `[from, to)`, re-asserting `style.on` after any SGR inside the
+ *  span (a reset there would otherwise drop the styling mid-span). A short row
+ *  is padded with spaces so a multi-row span reads as one block, never past
+ *  `maxCells`. Escapes are non-printing, so passes compose: styling an already
+ *  styled row leaves every cell position unmoved. */
+export function styleCells(line, from, to, maxCells, style = INVERSE_STYLE) {
     const end = Math.min(to, maxCells);
     if (end <= from || from < 0)
         return line;
     let out = '';
     let inside = false;
     const open = () => { if (!inside) {
-        out += INVERSE_ON;
+        out += style.on;
         inside = true;
     } };
     const close = () => { if (inside) {
-        out += INVERSE_OFF;
+        out += style.off;
         inside = false;
     } };
     const cells = walkRow(line, {
@@ -100,7 +102,7 @@ export function highlightCells(line, from, to, maxCells) {
             out += escape;
             // An SGR inside the span may have reset every attribute, including ours.
             if (inside && escape.endsWith('m'))
-                out += INVERSE_ON;
+                out += style.on;
         },
         onGlyph: (glyph) => {
             if (glyph.cell >= from && glyph.cell < end)
@@ -113,8 +115,12 @@ export function highlightCells(line, from, to, maxCells) {
     close();
     if (cells < end) {
         const gap = Math.max(0, from - cells);
-        const highlighted = end - Math.max(from, cells);
-        out += ' '.repeat(gap) + INVERSE_ON + ' '.repeat(highlighted) + INVERSE_OFF;
+        const styled = end - Math.max(from, cells);
+        out += ' '.repeat(gap) + style.on + ' '.repeat(styled) + style.off;
     }
     return out;
 }
+/** Reverse-video cells `[from, to)` — the drag-selection highlight. */
+export function highlightCells(line, from, to, maxCells) {
+    return styleCells(line, from, to, maxCells);
+}

package/dist/clients/attach/overlays/help.js

@@ -134,6 +134,12 @@ export class HelpOverlay {
             binding('crtr.attach.scroll.live', 'return to the live bottom'),
             muted('mouse wheel (when reporting is on)'),
             blank,
+            heading('Searching the transcript'),
+            { text: `${this.binding('crtr.attach.search')}  search what the transcript is currently showing. Type to jump as you go, enter to browse the matches.`, style: 'plain' },
+            { text: `${this.binding('crtr.attach.search.next')} / ${this.binding('crtr.attach.search.previous')}  next and previous match · ${this.binding('crtr.attach.search.edit')}  edit the query · ${this.binding('crtr.attach.search.close')}  close. Typing anything else closes search and returns to the editor.`, style: 'plain' },
+            { text: 'A lowercase query ignores case; any uppercase letter makes it case-sensitive.', style: 'plain' },
+            { text: 'Folded tool output is not on screen, so it is not searched — unfold it to include it.', style: 'muted' },
+            blank,
             heading('Selection and copy'),
             { text: 'Drag with the mouse to select; releasing copies the selection to the clipboard (and the tmux buffer). Any key clears the highlight.', style: 'plain' },
             { text: 'prefix + [  tmux copy-mode selects and copies the visible screenful; it works even while mouse reporting is on.', style: 'plain' },

package/dist/clients/attach/render/transcript-search.d.ts

@@ -0,0 +1,28 @@
+import type { ViewportSource } from './measured-container.js';
+/** One hit: an absolute content line and the cells it covers on that line. */
+export interface SearchMatch {
+    line: number;
+    from: number;
+    to: number;
+}
+export interface TranscriptSearchModel {
+    /** Replace the query; matches and the current hit are recomputed lazily. */
+    setQuery(query: string, near: number | undefined): void;
+    query(): string;
+    /** Every hit, oldest to newest, against the current content. */
+    matches(width: number): readonly SearchMatch[];
+    /** The selected hit, or undefined when the query finds nothing. */
+    current(width: number): SearchMatch | undefined;
+    /** Number of hits and the 1-indexed position of the selected one. */
+    status(width: number): {
+        index: number;
+        total: number;
+    };
+    /** Step the selection; wraps at both ends. Returns the new selection. */
+    step(width: number, direction: 1 | -1): SearchMatch | undefined;
+    /** Re-select the first hit at or after `line`, else the last one. */
+    selectNear(width: number, line: number): SearchMatch | undefined;
+    /** Paint hits onto one rendered transcript row. Identity without a query. */
+    decorate(line: number, rendered: string, width: number): string;
+}
+export declare function createTranscriptSearchModel(source: ViewportSource): TranscriptSearchModel;

package/dist/clients/attach/render/transcript-search.js

@@ -0,0 +1,153 @@
+// render/transcript-search.ts — the transcript search match model.
+//
+// Search runs over the RENDERED lines of the viewport source, not over a
+// separate text record, so it finds exactly what is on screen: a collapsed tool
+// group contributes no blocks to `ViewportSource`, so its output is not
+// searchable while it is folded, and folding it back open makes it searchable
+// again with no bookkeeping here.
+//
+// Matches are held as absolute content lines and terminal cell ranges, which is
+// what the viewport needs to scroll to one and what `highlightCells` needs to
+// paint one.
+import { styleCells, walkRow } from '../ansi-cells.js';
+/** Every hit is reverse-video; the one you are standing on is also underlined,
+ *  so a screen with several hits still says which of them `n` will leave.
+ *  Closing a span restores nothing, so the extra attribute is underline rather
+ *  than bold: transcript text runs bold often and underlined almost never. */
+const HIT_STYLE = { on: '\x1b[7m', off: '\x1b[27m' };
+const SELECTED_HIT_STYLE = { on: '\x1b[7m\x1b[4m', off: '\x1b[24m\x1b[27m' };
+function plainRow(line) {
+    let text = '';
+    const cells = [];
+    const width = walkRow(line, {
+        onGlyph: (glyph) => {
+            // One entry per code unit, so a string index maps straight back to a cell
+            // even across wide graphemes and surrogate pairs.
+            for (let i = 0; i < glyph.text.length; i++)
+                cells.push(glyph.cell);
+            text += glyph.text;
+        },
+    });
+    return { text, cells, width };
+}
+/** Vim smartcase: an all-lowercase query ignores case, any uppercase pins it. */
+function caseSensitive(query) {
+    return query !== query.toLowerCase();
+}
+function rowMatches(row, query, sensitive, line, out) {
+    const haystack = sensitive ? row.text : row.text.toLowerCase();
+    const needle = sensitive ? query : query.toLowerCase();
+    let at = haystack.indexOf(needle);
+    while (at !== -1) {
+        const end = at + needle.length;
+        const from = row.cells[at] ?? 0;
+        const to = end < row.cells.length ? row.cells[end] : row.width;
+        if (to > from)
+            out.push({ line, from, to });
+        at = haystack.indexOf(needle, at + Math.max(1, needle.length));
+    }
+}
+export function createTranscriptSearchModel(source) {
+    let query = '';
+    let selected = 0;
+    let cached = [];
+    let cachedByLine = new Map();
+    let cacheKey;
+    /** Where to re-anchor the selection after the next recompute. */
+    let pendingNear;
+    function ensure(width) {
+        const key = `${width}:${source.revision()}:${query}`;
+        if (cacheKey === key)
+            return cached;
+        const found = [];
+        if (query !== '') {
+            const sensitive = caseSensitive(query);
+            const count = source.blockCount();
+            for (let block = 0; block < count; block++) {
+                const start = source.blockStart(block, width);
+                const lines = source.blockLines(block, width);
+                for (let i = 0; i < lines.length; i++) {
+                    const line = lines[i];
+                    // Cheap reject before the cell walk: most rows never contain the
+                    // query, and plainRow() is the expensive part of this scan.
+                    if (!line.toLowerCase().includes(query.toLowerCase()))
+                        continue;
+                    rowMatches(plainRow(line), query, sensitive, start + i, found);
+                }
+            }
+        }
+        const byLine = new Map();
+        for (const match of found) {
+            const bucket = byLine.get(match.line);
+            if (bucket)
+                bucket.push(match);
+            else
+                byLine.set(match.line, [match]);
+        }
+        cached = found;
+        cachedByLine = byLine;
+        cacheKey = key;
+        if (pendingNear !== undefined) {
+            const near = pendingNear;
+            pendingNear = undefined;
+            const at = found.findIndex((match) => match.line >= near);
+            selected = at === -1 ? Math.max(0, found.length - 1) : at;
+        }
+        else if (selected >= found.length) {
+            selected = Math.max(0, found.length - 1);
+        }
+        return cached;
+    }
+    return {
+        setQuery(next, near) {
+            if (next === query)
+                return;
+            query = next;
+            pendingNear = near;
+            cacheKey = undefined;
+        },
+        query() {
+            return query;
+        },
+        matches(width) {
+            return ensure(width);
+        },
+        current(width) {
+            const found = ensure(width);
+            return found[selected];
+        },
+        status(width) {
+            const found = ensure(width);
+            return { index: found.length === 0 ? 0 : selected + 1, total: found.length };
+        },
+        step(width, direction) {
+            const found = ensure(width);
+            if (found.length === 0)
+                return undefined;
+            selected = (selected + direction + found.length) % found.length;
+            return found[selected];
+        },
+        selectNear(width, line) {
+            const found = ensure(width);
+            if (found.length === 0)
+                return undefined;
+            const at = found.findIndex((match) => match.line >= line);
+            selected = at === -1 ? found.length - 1 : at;
+            return found[selected];
+        },
+        decorate(line, rendered, width) {
+            if (query === '')
+                return rendered;
+            const found = ensure(width);
+            const bucket = cachedByLine.get(line);
+            if (bucket === undefined)
+                return rendered;
+            const selectedMatch = found[selected];
+            let painted = rendered;
+            for (const match of bucket) {
+                painted = styleCells(painted, match.from, match.to, width, match === selectedMatch ? SELECTED_HIT_STYLE : HIT_STYLE);
+            }
+            return painted;
+        },
+    };
+}

package/dist/clients/attach/render/viewport.d.ts

@@ -18,6 +18,12 @@ export interface TranscriptViewport {
     pageRows(): number;
     /** Pin back to the live bottom. */
     goLive(): void;
+    /** Bring absolute content `line` into view, seated a third of the way down
+     *  so the context around it reads. */
+    scrollToLine(line: number): void;
+    /** Absolute content line at the viewport's top row, or undefined before the
+     *  first render. */
+    topLine(): number | undefined;
     /** True while the viewport is pinned to the bottom. */
     isLive(): boolean;
     /** Flat blocks intersecting the visible slice and its last whole block. */
@@ -25,5 +31,8 @@ export interface TranscriptViewport {
     /** Forward frame invalidation without exposing the source to the frame. */
     invalidate(): void;
 }
-export declare function createTranscriptViewport(source: ViewportSource): TranscriptViewport;
+/** Restyle one rendered transcript row, addressed by its absolute content
+ *  line — how transcript search paints its hits. */
+export type RowDecorator = (line: number, rendered: string, width: number) => string;
+export declare function createTranscriptViewport(source: ViewportSource, decorate?: RowDecorator): TranscriptViewport;
 export {};

package/dist/clients/attach/render/viewport.js

@@ -18,7 +18,7 @@ function firstBlockAfter(source, line, width) {
     }
     return low;
 }
-export function createTranscriptViewport(source) {
+export function createTranscriptViewport(source, decorate) {
     const state = { follow: true, anchor: undefined };
     let lastWidth;
     let lastRows = 0;
@@ -101,9 +101,13 @@ export function createTranscriptViewport(source) {
                 if (partiallyClipped && isInlineImageBlock(lines)) {
                     content.push(...Array(visibleEnd - visibleStart).fill(CLIPPED_IMAGE_ROW));
                 }
-                else {
+                else if (decorate === undefined) {
                     content.push(...lines.slice(visibleStart, visibleEnd));
                 }
+                else {
+                    for (let row = visibleStart; row < visibleEnd; row++)
+                        content.push(decorate(start + row, lines[row], width));
+                }
             }
             const padded = content.length >= viewportRows
                 ? content.slice(0, viewportRows)
@@ -140,6 +144,27 @@ export function createTranscriptViewport(source) {
             state.follow = true;
             state.anchor = undefined;
         },
+        scrollToLine(line) {
+            if (lastWidth === undefined || lastRows <= 0)
+                return;
+            const total = source.totalHeight(lastWidth);
+            const bottom = Math.max(0, total - lastRows);
+            const top = Math.min(Math.max(0, line - Math.floor(lastRows / 3)), bottom);
+            if (top >= bottom) {
+                state.follow = true;
+                state.anchor = undefined;
+                return;
+            }
+            state.follow = false;
+            state.anchor = source.anchorAt(top, lastWidth);
+            if (!state.anchor)
+                state.follow = true;
+        },
+        topLine() {
+            if (lastWidth === undefined || lastRows <= 0)
+                return undefined;
+            return resolveTop(lastWidth, lastRows, source.totalHeight(lastWidth));
+        },
         isLive() {
             return state.follow;
         },

package/dist/clients/attach/session/frame.d.ts

@@ -4,7 +4,8 @@ export declare const MIN_TRANSCRIPT_ROWS = 3;
 export declare const HEADER_MAX_ROWS = 12;
 export declare const EDITOR_MIN_ROWS = 1;
 export declare const STATUS_ROWS = 1;
-export type BottomSlot = 'queued' | 'aboveWidgets' | 'activity' | 'cockpitPadding' | 'editor' | 'pickerPanel' | 'belowWidgets' | 'reports' | 'footer';
+export declare const SEARCH_ROWS = 1;
+export type BottomSlot = 'queued' | 'aboveWidgets' | 'activity' | 'cockpitPadding' | 'editor' | 'pickerPanel' | 'belowWidgets' | 'reports' | 'search' | 'footer';
 /** Crop `lines` to `alloc` rows, guaranteeing the CURSOR_MARKER row survives
  * (§2.1). No marker → the tail is kept. */
 export declare function cropAroundCursor(lines: readonly string[], alloc: number): string[];

package/dist/clients/attach/session/frame.js

@@ -10,6 +10,7 @@ export const MIN_TRANSCRIPT_ROWS = 3;
 export const HEADER_MAX_ROWS = 12;
 export const EDITOR_MIN_ROWS = 1;
 export const STATUS_ROWS = 1;
+export const SEARCH_ROWS = 1;
 /** Crop `lines` to `alloc` rows, guaranteeing the CURSOR_MARKER row survives
  * (§2.1). No marker → the tail is kept. */
 export function cropAroundCursor(lines, alloc) {
@@ -48,6 +49,7 @@ const SLOT_VISUAL_ORDER = [
     'pickerPanel',
     'belowWidgets',
     'reports',
+    'search',
     'footer',
 ];
 /** The TUI's ONE child. Renders exactly `terminal.rows` lines, every frame. */
@@ -76,6 +78,13 @@ export class ViewerFrame {
         const statusAlloc = footerLines.length > 0 && remaining > EDITOR_MIN_ROWS ? STATUS_ROWS : 0;
         allocate('footer', statusAlloc === 0 ? [] : footerLines.slice(-statusAlloc));
         remaining -= statusAlloc;
+        // Search sits with the status line rather than in the priority table: while
+        // it is up it owns typed input, so a frame that drops it would leave the
+        // user typing into an invisible mode.
+        const searchLines = linesFor('search');
+        const searchAlloc = searchLines.length > 0 && remaining > EDITOR_MIN_ROWS ? SEARCH_ROWS : 0;
+        allocate('search', searchAlloc === 0 ? [] : searchLines.slice(-searchAlloc));
+        remaining -= searchAlloc;
         const pickerLines = linesFor('pickerPanel');
         const pickerReserve = pickerLines.length === 0 ? 0 : Math.min(pickerLines.length, Math.floor(remaining / 2));
         const editorLines = linesFor('editor');

package/dist/clients/attach/session/keys.d.ts

@@ -11,6 +11,9 @@ export interface KeyHooks {
     hasExclusiveSurface: () => boolean;
     /** Scroll actions for this session's transcript viewport. */
     viewportActions: () => AttachViewportActions;
+    /** Transcript search's chance at a chunk; true when it consumed it. It owns
+     *  typed characters while editing a query, so it runs ahead of the editor. */
+    searchHandleKey: (data: string) => boolean;
     /** The roster's chance at a chunk; true when it consumed it. */
     rosterHandleKey: (data: string) => boolean;
     setNotice: (message: string) => void;
@@ -25,6 +28,8 @@ export interface KeyHooks {
     openFileReview: () => void;
     /** Search the current node's local profile project files. */
     openProfileFiles: () => void;
+    /** Open incremental search over the displayed transcript. */
+    openSearch: () => void;
     /** Play the whip animation and interrupt the focused agent with a command. */
     whip: () => void;
 }

package/dist/clients/attach/session/keys.js

@@ -39,6 +39,7 @@ export function installGlobalKeys(ctx, hooks) {
         'crtr.attach.command.inspect': hooks.inspectLoadedCommand,
         'crtr.attach.file-review': hooks.openFileReview,
         'crtr.attach.profile-files': hooks.openProfileFiles,
+        'crtr.attach.search': hooks.openSearch,
         'crtr.attach.whip': hooks.whip,
     };
     return tui.addInputListener((data) => {
@@ -56,6 +57,8 @@ export function installGlobalKeys(ctx, hooks) {
         }
         if (hooks.hasExclusiveSurface())
             return undefined;
+        if (hooks.searchHandleKey(data))
+            return { consume: true };
         // Let focused pickers and overlays retain their native page navigation.
         if (editor.focused && dispatchAttachViewportBinding(hooks.bindings(), data, hooks.viewportActions()))
             return { consume: true };

package/dist/clients/attach/session/layout.d.ts

@@ -1,4 +1,4 @@
-import { Container, type KeybindingsManager, type ProcessTerminal, type TUI } from '@earendil-works/pi-tui';
+import { Container, type Component, type KeybindingsManager, type ProcessTerminal, type TUI } from '@earendil-works/pi-tui';
 import type { AttachPalette } from '../config.js';
 import { TitledEditor } from '../input/titled-editor.js';
 import type { TranscriptViewport } from '../render/viewport.js';
@@ -19,4 +19,4 @@ export interface AttachLayout {
 }
 /** Build the layout around the transcript viewport. The viewer creates the
  * terminal and chat first because the viewport measures that chat source. */
-export declare function createLayout(procTerminal: ProcessTerminal, tui: TUI, chat: Container, activity: Container, pal: AttachPalette, km: KeybindingsManager, viewport: TranscriptViewport): AttachLayout;
+export declare function createLayout(procTerminal: ProcessTerminal, tui: TUI, chat: Container, activity: Container, pal: AttachPalette, km: KeybindingsManager, viewport: TranscriptViewport, searchBar: Component): AttachLayout;

package/dist/clients/attach/session/layout.js

@@ -8,7 +8,7 @@
 // The render order is asserted in ONE place (`ViewerFrame`'s bottom list).
 // Top to bottom: pinned recap header · virtualized chat · cockpit padding · fixed activity ·
 // above-editor extension widgets · queued · editor · picker panel · below-editor
-// extension widgets · roster · status bar. The frame owns the pane rectangle,
+// extension widgets · roster · search bar · status bar. The frame owns the pane rectangle,
 // so every region remains on screen and none can enter terminal scrollback.
 import { Container, Spacer } from '@earendil-works/pi-tui';
 import { getSelectListTheme } from '@earendil-works/pi-coding-agent';
@@ -16,7 +16,7 @@ import { TitledEditor } from '../input/titled-editor.js';
 import { ViewerFrame } from './frame.js';
 /** Build the layout around the transcript viewport. The viewer creates the
  * terminal and chat first because the viewport measures that chat source. */
-export function createLayout(procTerminal, tui, chat, activity, pal, km, viewport) {
+export function createLayout(procTerminal, tui, chat, activity, pal, km, viewport, searchBar) {
     const containers = {
         chat,
         header: new Container(),
@@ -44,6 +44,7 @@ export function createLayout(procTerminal, tui, chat, activity, pal, km, viewpor
             { slot: 'pickerPanel', component: containers.pickerPanel },
             { slot: 'belowWidgets', component: containers.belowWidgets },
             { slot: 'reports', component: containers.reports },
+            { slot: 'search', component: searchBar },
             { slot: 'footer', component: containers.footer },
         ],
     });

package/dist/clients/attach/session/transcript-search.d.ts

@@ -0,0 +1,20 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+import type { TranscriptViewport } from '../render/viewport.js';
+import type { TranscriptSearchModel } from '../render/transcript-search.js';
+import { type AttachBindings } from './bindings.js';
+export interface TranscriptSearch {
+    /** The bar, mounted as a fixed frame slot; renders nothing while closed. */
+    readonly component: Component;
+    /** Enter search. A repeat open re-edits the previous query. */
+    open(): void;
+    close(): void;
+    /** True when search owns the key chunk. Declines everything it does not own,
+     *  so scroll bindings and ordinary editor input still work while it is up. */
+    handleKey(data: string): boolean;
+}
+export interface TranscriptSearchHooks {
+    bindings: () => AttachBindings;
+    setNotice: (message: string) => void;
+}
+export declare function createTranscriptSearch(tui: TUI, pal: AttachPalette, viewport: TranscriptViewport, model: TranscriptSearchModel, hooks: TranscriptSearchHooks): TranscriptSearch;