@north-light/crouter 0.3.170 → 0.3.172

package/dist/clients/attach/render/chat-view.d.ts

@@ -1,8 +1,24 @@
-import { Container, type TUI } from '@earendil-works/pi-tui';
+import { Container, Loader, type Component, type TUI } from '@earendil-works/pi-tui';
 import { type AgentSessionEvent } from '@earendil-works/pi-coding-agent';
 import type { BrokerSnapshot } from '../../../core/runtime/broker-protocol.js';
 import { type AttachPalette } from '../config.js';
+import { type ToolGroupSummary } from '../../../shared/tool-groups.js';
+import { type ViewportSource } from './measured-container.js';
 import type { CondensedHistoryMode } from '../../../types.js';
+export type ToolDisplayToggle = {
+    kind: 'summaries';
+    shown: boolean;
+} | {
+    kind: 'output';
+    expanded: boolean;
+};
+export type CopyBlockKind = 'user' | 'assistant' | 'tool' | 'condensed';
+/** One copyable unit, bound to the exact top-level component the viewport addresses. */
+export interface CopyBlock {
+    block: Component;
+    kind: CopyBlockKind;
+    text: string;
+}
 export interface ChatViewOptions {
     /** Working dir used by `ToolExecutionComponent` for path/diff display. Defaults
      *  to the viewer's cwd; T7 may pass the node's working dir for nicer paths. */
@@ -24,6 +40,9 @@ export interface ChatViewOptions {
     /** Theme palette for the activity spinner / dim status / error lines. Absent →
      *  the module defaults (faint + ANSI red) are used. */
     palette?: AttachPalette;
+    /** Viewer-owned fixed activity slot. When supplied, activity stays outside
+     *  the scrolling transcript and this callback swaps its sole loader. */
+    onActivityChange?: (loader: Loader | undefined) => void;
     /** Trailing refresh-yield cycles rendered at full fidelity; older cycles are
      *  condensed to lightweight, reflowing content (see condensed-history.ts).
      *  Absent → the user's `live_cycles` config setting, itself defaulting to 2. */
@@ -44,8 +63,12 @@ export declare class ChatView {
     /** Settled history is cached independently from the live status area so picker
      *  navigation does not re-render a long conversation on every key repeat. */
     private readonly historyContainer;
-    /** Activity/status area below history. Holds working/compaction/retry loaders. */
+    /** Standalone ChatViews render activity inline; the attach viewer supplies
+     *  `onActivityChange`, so its transcript excludes this container. */
     private readonly statusContainer;
+    /** Optional banner, above history and status in the viewport's flat source. */
+    private readonly bannerContainer;
+    private readonly transcript;
     /** Where `append()` puts a component. Normally `historyContainer`; retargeted to
      *  a nested container while condensed history is being built, so the same
      *  message-rendering path serves both regions. */
@@ -61,17 +84,37 @@ export declare class ChatView {
     private readonly hiddenThinkingLabel;
     /** Ctrl+O: pi's two-state tool-output expansion. */
     private toolOutputExpanded;
-    /** The view setting (Alt+C → w → f): fold every SETTLED tool call to its single
+    /** The view setting (Alt+C → z → f): fold every SETTLED tool call to its single
      *  call line. Independent of `toolOutputExpanded` — it survives an expand/collapse
      *  and only ever applies to tool calls that are done. */
     private foldSettledTools;
+    /** Summary mode only changes Ctrl+O when both persistent settings are on. */
+    private readonly summarizeToolCalls;
+    private readonly detailedToolRecaps;
+    private showGroupSummaries;
+    /** Groups exist only while building/rendering the full-fidelity live region. */
+    private readonly groups;
+    private openGroup;
+    private readonly groupSummaries;
+    private streamingWasGroupMember;
     private readonly onFooterEvent;
+    /** Viewer hook that places activity in its fixed slot, when available. */
+    private readonly onActivityChange;
     /** Theme-derived colorizers for the activity/status area. */
     private readonly spinnerStyle;
     private readonly dimStyle;
     private readonly errorStyle;
+    /** Palette shared with recap rows that render outside pi tool callbacks. */
+    private readonly recapPalette;
     /** Bold accent for the expanded crtr-context label. */
     private readonly labelStyle;
+    /** Raw broker messages retained beside their viewer components so a local
+     *  Ctrl+O disclosure toggle can re-project settled Markdown without touching
+     *  persisted/copyable source. Includes condensed-history components. */
+    private readonly assistantSources;
+    /** Undefined honors each `<details open>` attribute until Ctrl+O establishes
+     *  one viewer-wide disclosure state. */
+    private detailsExpandedOverride;
     /** The assistant message component currently being streamed (between
      *  message_start and message_end for an assistant turn). */
     private streamingComponent;
@@ -87,6 +130,10 @@ export declare class ChatView {
     private bashComponent;
     /** The single active activity loader (working/compaction/retry), if any. */
     private activityLoader;
+    /** Broker-selected normal label for this turn; compaction/retry temporarily
+     *  replace it and restore it when the run remains active. */
+    private workingActivity;
+    private runActive;
     /** True while applySnapshot is mid-build; live broker frames defer instead of
      *  mutating the partially-rebuilt view. */
     private applyingSnapshot;
@@ -106,7 +153,15 @@ export declare class ChatView {
     private readonly transcriptTexts;
     /** Existing file paths found anywhere in the rendered transcript, newest first. */
     private readonly transcriptFilePaths;
+    /** Canonical copyable transcript blocks, in their rendered visual order. */
+    private readonly copyBlockRecords;
+    private readonly copyIndex;
+    /** Registrations made while building condensed history are collapsed onto its
+     * outer container once that container becomes a top-level viewport block. */
+    private readonly condensedCopyBlocks;
     constructor(tui: TUI, container: Container, opts?: ChatViewOptions);
+    /** The transcript as one flat ordered block list for the viewport. */
+    transcriptSource(): ViewportSource;
     /** Render the full message history from a `welcome` snapshot. Ports pi's
      *  `renderSessionContext` (interactive-mode.js:2553): assistant messages spawn
      *  tool-execution components matched to their toolResult messages; everything
@@ -133,23 +188,24 @@ export declare class ChatView {
     /** Replay deferred live frames in wire order. The gate is already open, so each
      *  closure re-enters its entry point and dispatches immediately. */
     private replayDeferredFrames;
+    /** Accept the broker's per-turn random choice before its following agent_start. */
+    setWorkingActivity(activity: string): void;
     /** Clear live turn state after the broker reports completion or the viewer observes dormancy. */
     settleRun(): void;
     /** Stop any spinning activity loader. A one-shot `crtr surface attach` process lets its
      *  timers die with the process, but if T7 reuses a ChatView across reconnects in
      *  one process it should call this on detach to avoid a leaked interval. */
     dispose(): void;
-    /** Ctrl+O / app.tools.expand — flip global tool-output expansion and apply it to
-     *  every rendered component that supports it. Returns the new expanded state so
-     *  the caller can surface a notice. Condensed cycles hold no tool components, so
-     *  they are unaffected by design. */
-    toggleToolsExpanded(): boolean;
-    /** The `fold finished tool calls` view setting (`/fold-tools`, Alt+C → w → f).
+    /** Ctrl+O prefers summaries when the user enabled both folding and summary
+     * generation. The same disclosure state drives assistant-authored `<details>`
+     * sections, so the transcript has one reveal-more action rather than two. */
+    toggleToolsExpanded(): ToolDisplayToggle;
+    /** The `fold finished tool calls` view setting (`/fold-tools`, Alt+C → z → f).
      *  Returns the new state so the caller can surface a notice. */
     toggleFoldSettledTools(): boolean;
     /** Push both display settings onto every rendered component. A tool call still in
-     *  `pendingTools` is in flight, so it is never folded — you keep watching live
-     *  output, and it folds on its own once `tool_execution_end` settles it. */
+     *  flight is never hidden or minimized. Only a settled group with a broker-known
+     *  summary collapses; incomplete/failed generation leaves its folded call lines. */
     private applyToolDisplay;
     /** Ctrl+T / app.thinking.toggle — flip thinking-block visibility and apply it to
      *  every assistant message (the in-flight streaming bubble is itself a child of
@@ -169,7 +225,34 @@ export declare class ChatView {
     private appendAssistantMessage;
     /** Add a separator in transcript order now; it renders only after a following
      * tool settles in the folded view. */
-    private appendFoldedToolSeparator;
+    private appendAssistantSeparator;
+    private appendAssistantPart;
+    private appendUserPart;
+    /** Only the full-fidelity trailing region gets summary groups. Condensed
+     * history intentionally drops tool traffic, so grouping there would create
+     * phantom summary rows and cross the live/condensed boundary. */
+    private isLiveGroupRegion;
+    private ensureGroup;
+    private closeOpenGroup;
+    private appendGroupMember;
+    /** Used for context that may join an existing run but must not create one. */
+    private appendExistingGroupMember;
+    private removeGroupMember;
+    /** Add one tool as a group member, moving the assistant's boundary separator
+     * behind the new summary row without changing the separator's identity. */
+    private appendToolComponent;
+    private noteGroupTool;
+    private settleGroupTool;
+    /** An assistant starts as a non-boundary while its text is empty. Visible prose
+     * or a terminal failure turns it into a boundary without recreating either
+     * pi-owned component (their direct-child cache identities remain intact). */
+    private promoteStreamingAssistantToBoundary;
+    private seedToolGroupSummaries;
+    /** Broker frames can arrive before or after their group's events, and snapshot
+     * rebuilding defers them through the single-writer gate, so this stores first
+     * and applies to every currently-rendered matching group. */
+    applyToolGroupSummary(key: string, summary: ToolGroupSummary): void;
+    private applyGroupDisplay;
     /** Make each separator visible only if its immediately-following tool call is
      * actually folded; in-flight calls remain flush with their live output. */
     private updateFoldedToolSeparators;
@@ -181,6 +264,15 @@ export declare class ChatView {
     /** Append conversation content above the independent live status area — or into
      *  the nested container while condensed history is under construction. */
     private append;
+    /** Project one raw assistant message through every attach-local Markdown
+     * transform. This is the sole pipeline used by snapshots, streaming, settled
+     * messages, and Ctrl+O re-renders. */
+    private renderAssistantMessage;
+    /** Retain canonical source and update one stable transcript component with its
+     * viewer-local projection. */
+    private updateAssistantComponent;
+    /** Re-project every assistant component in place after a disclosure toggle. */
+    private rerenderAssistantMessages;
     /** Approximate render width for inline mermaid diagrams. Only affects
      *  termrender's trailing padding (stripped in the transform), so the terminal
      *  column count is close enough without threading the live pane width here. */
@@ -207,6 +299,19 @@ export declare class ChatView {
     /** The text of the most recent assistant message, for `/copy`. Undefined when
      *  no assistant message has been seen (or it had no text content). */
     getLastAssistantText(): string | undefined;
+    /** Copyable source text for a transcript block, if it has any. */
+    blockText(block: Component): string | undefined;
+    /** The canonical ordered copy record, oldest → newest. */
+    copyBlocks(): readonly CopyBlock[];
+    /** Newest tool call's result text (`/copy-tool`). */
+    getLastToolOutputText(): string | undefined;
+    /** Every copyable block's text, oldest → newest, joined by blank lines. */
+    getTranscriptPlainText(): string;
+    private registerCopyBlock;
+    private unregisterCopyBlock;
+    private appendCondensedBlock;
+    /** Flatten arbitrary tool result payloads into the visible text copy target. */
+    private toolResultText;
     private pushTranscriptText;
     private pushTranscriptValue;
     /** Concatenate the text blocks of a user message (string or content array). */