@peasant-labs/fairtrade 0.0.45 → 0.0.47

package/dist/lib/types/transcript/Minimap.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @param {object} props
+ * @param {TurnVM[]} [props.turns]        the turns the reader can currently see, in turn order
+ * @param {number} [props.activeTurn]     the active TURN INDEX (TurnVM.index)
+ * @param {(turnIndex: number) => void} [props.onJump]
+ * @param {string} [props.label]          accessible name for the slider
+ */
+export default function TranscriptMinimap({ turns, activeTurn, onJump, label, }: {
+    turns?: TurnVM[];
+    activeTurn?: number;
+    onJump?: (turnIndex: number) => void;
+    label?: string;
+}): import("react").JSX.Element;
+export type TurnVM = import("./view-model.js").TurnVM;

package/dist/lib/types/transcript/OutlineRail.d.ts

@@ -2,12 +2,17 @@
  * @param {object} props
  * @param {TranscriptViewModel} props.viewModel
  * @param {import('./state-capabilities.js').TranscriptTab} props.tab
+ * @param {Presentation} [props.presentation]          chrome mode; defaults to 'classic'
+ * @param {number} [props.activeTurn]                   the active TURN INDEX, for the ledger cards
  * @param {(turnIndex: number) => void} [props.onJump]
  */
-export default function OutlineRail({ viewModel, tab, onJump }: {
+export default function OutlineRail({ viewModel, tab, onJump, presentation, activeTurn }: {
     viewModel: TranscriptViewModel;
     tab: import("./state-capabilities.js").TranscriptTab;
+    presentation?: Presentation;
+    activeTurn?: number;
     onJump?: (turnIndex: number) => void;
 }): import("react").JSX.Element;
 export type TranscriptViewModel = import("./view-model.js").TranscriptViewModel;
 export type AnnotationVM = import("./view-model.js").AnnotationVM;
+export type Presentation = import("./state-capabilities.js").Presentation;

package/dist/lib/types/transcript/SystemRow.d.ts

@@ -0,0 +1,17 @@
+/** @typedef {import('./view-model.js').TurnVM} TurnVM */
+/**
+ * @param {object} props
+ * @param {TurnVM} [props.turn]
+ * @param {import('react').ReactNode} [props.actions]  the turn's trailing controls (copy anchor + host actions)
+ * @param {boolean} [props.open]        controlled disclosure state; omit to let the row own it
+ * @param {(open: boolean) => void} [props.onToggle]  called with the next state whenever the disclosure changes
+ * @param {number} [props.revealRequest] explicit search navigation sequence; a new value opens the row
+ */
+export default function TranscriptSystemRow({ turn, actions, open: openProp, onToggle, revealRequest }: {
+    turn?: TurnVM;
+    actions?: import("react").ReactNode;
+    open?: boolean;
+    onToggle?: (open: boolean) => void;
+    revealRequest?: number;
+}): import("react").JSX.Element;
+export type TurnVM = import("./view-model.js").TurnVM;

package/dist/lib/types/transcript/ToolCall.d.ts

@@ -4,7 +4,7 @@
  * @param {boolean} [props.open]
  * @param {() => void} [props.onToggle]
  */
-export default function ToolCall({ tool, open, onToggle }: {
+export default function ToolCall({ tool, open, onToggle, showChevron }: {
     tool?: ToolCallVM;
     open?: boolean;
     onToggle?: () => void;

package/dist/lib/types/transcript/TranscriptViewer.d.ts

@@ -1,7 +1,8 @@
 /**
  * @param {TranscriptViewerProps} props
  */
-export default function TranscriptViewer({ viewModel, capabilities, callbacks, theme: themeProp, onThemeChange, graphSlot, activeTab: activeTabProp, onTabChange, viewMode: viewModeProp, onViewModeChange, leftRailOpen: leftRailOpenProp, onLeftRailOpenChange, rightRailOpen: rightRailOpenProp, onRightRailOpenChange, openTools: openToolsProp, onOpenToolsChange, earlierHistoryOpen: earlierHistoryOpenProp, onEarlierHistoryOpenChange, initialPosition: initialPositionProp, activeTurn: activeTurnProp, onActiveTurnChange, search: searchProp, onSearchChange, filters: filtersProp, onFiltersChange, savedLabels: savedLabelsProp, onSavedLabelsChange, shareOpen: shareOpenProp, onShareOpenChange, moreOpen: moreOpenProp, onMoreOpenChange, breadcrumb, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, streamPrelude, showTail, showOutcome, showSearchTrigger, pullRequests, headingLevel, }: TranscriptViewerProps): import("react").JSX.Element;
+export default function TranscriptViewer({ viewModel, capabilities, callbacks, theme: themeProp, onThemeChange, graphSlot, activeTab: activeTabProp, onTabChange, viewMode: viewModeProp, onViewModeChange, sidebarLayout: sidebarLayoutProp, onSidebarLayoutChange, zen: zenProp, onZenChange, readerWidth: readerWidthProp, onReaderWidthChange, leftRailOpen: leftRailOpenProp, onLeftRailOpenChange, rightRailOpen: rightRailOpenProp, onRightRailOpenChange, openTools: openToolsProp, onOpenToolsChange, earlierHistoryOpen: earlierHistoryOpenProp, onEarlierHistoryOpenChange, initialPosition: initialPositionProp, activeTurn: activeTurnProp, onActiveTurnChange, search: searchProp, onSearchChange, filters: filtersProp, onFiltersChange, savedLabels: savedLabelsProp, onSavedLabelsChange, shareOpen: shareOpenProp, onShareOpenChange, moreOpen: moreOpenProp, onMoreOpenChange, breadcrumb, LinkComponent, renderTurnPanel, renderTurnActions, anchorHref, headerActions, streamPrelude, showTail, showOutcome, showSearchTrigger, footer, presentation, subtitle, pullRequests, headingLevel, }: TranscriptViewerProps): import("react").JSX.Element;
+export const READER_SNAPS: readonly number[];
 export type TranscriptViewerProps = import("./state-capabilities.js").TranscriptViewerProps;
 export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;
 export type TraceReadingSnapshot = {

package/dist/lib/types/transcript/TurnCard.d.ts

@@ -15,8 +15,16 @@
  * @param {number} [props.revealRequest] explicit search navigation sequence
  * @param {number} [props.headingLevel=4] the turn heading's level: h4 under a viewer whose title is an h2, h3 under one
  *        whose title is the page's h1
+ * @param {'classic' | 'ledger'} [props.presentation='classic'] chrome presentation. `ledger` leads with a
+ *        square role well and the role word, groups the turn's tool calls into one work panel, and renders a
+ *        system turn as a compact row; absent, the classic card renders exactly as before. In ledger the head
+ *        carries only the role, the turn number, the time, and the copy anchor (plus the host's
+ *        `renderActions`); the built-in collapse control, label affordance, model name, error chip, token
+ *        badge, and saved-label chip are intentionally hidden there for now. The host's own per-turn
+ *        `renderActions` and `renderTurnPanel` keep rendering on every role, so a host extension is never
+ *        dropped by the presentation switch.
  */
-export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, headingLevel, }: {
+export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAnchor, copied, registerRef, onLabel, renderActions, savedLabel, compact, expandAll, revealRequest, headingLevel, presentation, }: {
     turn?: TurnVM;
     active?: boolean;
     openTools?: Record<string, boolean>;
@@ -34,5 +42,6 @@ export default function TurnCard({ turn, active, openTools, toggleTool, onCopyAn
     expandAll?: boolean;
     revealRequest?: number;
     headingLevel?: number;
+    presentation?: "classic" | "ledger";
 }): import("react").JSX.Element;
 export type TurnVM = import("./view-model.js").TurnVM;

package/dist/lib/types/transcript/WorkGroup.d.ts

@@ -0,0 +1,15 @@
+/** @typedef {import('./view-model.js').ToolCallVM} ToolCallVM */
+/**
+ * @param {object} props
+ * @param {ToolCallVM[]} [props.tools]      the turn's cooked tool calls
+ * @param {Record<string, boolean>} [props.openTools]  tool id -> open?
+ * @param {(id: string) => void} [props.onToggle]
+ * @param {boolean} [props.expandAll]
+ */
+export default function TranscriptWorkGroup({ tools, thinking, openTools, onToggle, expandAll, bare }: {
+    tools?: ToolCallVM[];
+    openTools?: Record<string, boolean>;
+    onToggle?: (id: string) => void;
+    expandAll?: boolean;
+}): import("react").JSX.Element;
+export type ToolCallVM = import("./view-model.js").ToolCallVM;

package/dist/lib/types/transcript/index.d.ts

@@ -1,18 +1,21 @@
 export { TOOL_GROUPS } from "./view-model.js";
 export { nextNavTurn } from "./turnNav.js";
+export { workSummary } from "./work-summary.js";
 export { default as TranscriptTurnCard } from "./TurnCard.jsx";
 export { default as TranscriptThinking } from "./Thinking.jsx";
 export { default as TranscriptMarkdown } from "./Markdown.jsx";
 export { default as TranscriptToolCall } from "./ToolCall.jsx";
+export { default as TranscriptWorkGroup } from "./WorkGroup.jsx";
+export { default as TranscriptSystemRow } from "./SystemRow.jsx";
 export { default as TranscriptToolBody } from "./ToolBody.jsx";
 export { default as TranscriptTaskBody } from "./TaskBody.jsx";
 export { default as TranscriptOutcomeChip } from "./OutcomeChip.jsx";
-export { default as TranscriptViewer } from "./TranscriptViewer.jsx";
 export { default as TranscriptOutlineRail } from "./OutlineRail.jsx";
 export { default as TranscriptFiltersRail } from "./FiltersRail.jsx";
 export { default as TranscriptFilterSection } from "./FilterSection.jsx";
 export { default as TranscriptCheckRow } from "./CheckRow.jsx";
 export { default as TranscriptViewSwitch } from "./ViewSwitch.jsx";
+export { default as TranscriptMinimap } from "./Minimap.jsx";
 export { default as TranscriptScrubber } from "./Scrubber.jsx";
 export { default as TranscriptScorecard } from "./Scorecard.jsx";
 export { default as TranscriptLabelPopover } from "./LabelPopover.jsx";
@@ -44,8 +47,10 @@ export type ViewerCapabilities = import("./state-capabilities.js").ViewerCapabil
 export type ViewerCallbacks = import("./state-capabilities.js").ViewerCallbacks;
 export type GraphSlotContext = import("./state-capabilities.js").GraphSlotContext;
 export type TranscriptFilters = import("./state-capabilities.js").TranscriptFilters;
+export type TranscriptSidebarLayout = import("./state-capabilities.js").TranscriptSidebarLayout;
 export type SavedLabel = import("./state-capabilities.js").SavedLabel;
 export type Theme = import("./state-capabilities.js").Theme;
+export type Presentation = import("./state-capabilities.js").Presentation;
 export type TranscriptTab = import("./state-capabilities.js").TranscriptTab;
 export type ViewMode = import("./state-capabilities.js").ViewMode;
 export type TranscriptViewModel = import("./view-model.js").TranscriptViewModel;
@@ -77,4 +82,5 @@ export { computeTasks, computeTurnLabels, buildTaskWaterfall, annotateTranscript
 export { formatRelative, formatDurationMins, formatDurationMs, formatDurationSeconds, formatDateLong, isKnownTime } from "./time.js";
 export { summarizePrompt, composeSessionTitle, projectLabel, cleanSessionTitle, unwrapUserQuery } from "./title.js";
 export { default as TranscriptDiffEntryCard, DiffHunks as TranscriptDiffHunks } from "./DiffEntryCard.jsx";
+export { default as TranscriptViewer, READER_SNAPS } from "./TranscriptViewer.jsx";
 export { advanceTranscriptInitialPositionConsumption, normalizeTranscriptInitialPosition, resolveTranscriptInitialPosition, shouldApplyTranscriptInitialPosition, transcriptInitialPositionReadiness, transcriptInitialPositionToken } from "./initial-position.js";

package/dist/lib/types/transcript/plain-text.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The readable text of a Markdown source string, collapsed to one line.
+ *
+ * @param {unknown} content the recorded or display Markdown
+ * @returns {string}
+ */
+export function plainTextPreview(content: unknown): string;

package/dist/lib/types/transcript/state-capabilities.d.ts

@@ -11,6 +11,12 @@ export type ViewMode = "list" | "graph";
  * The optional theme; defaults to `dark` when unset.
  */
 export type Theme = "dark" | "light";
+/**
+ * How the composite presents: `classic` (the default bordered-turn reading surface) or
+ * `ledger` (the opt-in reading-first surface: role-led turns with one grouped work panel,
+ * system turns as single rows, and the ledger chrome).
+ */
+export type Presentation = "classic" | "ledger";
 /**
  * A per-turn saved label (the LabelPopover's output). `outcome` is the verdict
  * band; `flag` is an optional friction tag. Keyed by turn index in `savedLabels`.
@@ -19,6 +25,29 @@ export type SavedLabel = {
     outcome: "good" | "neutral" | "bad";
     flag?: string;
 };
+/**
+ * The expanded/collapsed configuration of the viewer's surroundings: the left user-turns
+ * outline, the right filters rail, and the host-owned sidebar (which the viewer never
+ * renders, but which the host hides and restores from this same object). The host may
+ * persist it; the viewer reports every explicit change through `onSidebarLayoutChange`.
+ * Reading width never changes it. Zen collapses it and restores the exact snapshot.
+ * `host` defaults to `true` when neither the prop nor an explicit action supplies it; the
+ * viewer never renders that sidebar, so the value only relays the host's own state.
+ */
+export type TranscriptSidebarLayout = {
+    /**
+     * the left user-turns rail
+     */
+    outline: boolean;
+    /**
+     * the right filters rail
+     */
+    filters: boolean;
+    /**
+     * the host-owned sidebar
+     */
+    host: boolean;
+};
 /**
  * The cooked filter state the FiltersRail drives. Categories gate turn KINDS;
  * `toolGroups` gate tool-call groups (keyed by the cooked `ToolGroup` ids);
@@ -148,8 +177,32 @@ export type TranscriptViewerProps = {
     onTabChange?: (tab: TranscriptTab) => void;
     viewMode?: ViewMode;
     onViewModeChange?: (mode: ViewMode) => void;
+    /**
+     * the single rail + host-sidebar view model; supplied, it is the source of truth for `outline`, `filters` and `host`
+     */
+    sidebarLayout?: TranscriptSidebarLayout;
+    /**
+     * fires the FULL layout object on every explicit rail action and on zen entry and exit
+     */
+    onSidebarLayoutChange?: (layout: TranscriptSidebarLayout) => void;
+    /**
+     * ledger only: reading mode collapses both viewer rails to nothing (their strips leave too) and `host` reports false; ignored in classic; defaults false
+     */
+    zen?: boolean;
+    onZenChange?: (zen: boolean) => void;
+    /**
+     * ledger only: the reader column width in CSS pixels. A supplied value is normalised at the boundary (clamped to 600..936 and snapped to the nearest of the exported `READER_SNAPS`), so the column and `aria-valuenow` always report a supported width; defaults 840
+     */
+    readerWidth?: number;
+    onReaderWidthChange?: (width: number) => void;
+    /**
+     * alias for `sidebarLayout.outline`; when supplied it wins for that rail and still calls `onLeftRailOpenChange`
+     */
     leftRailOpen?: boolean;
     onLeftRailOpenChange?: (open: boolean) => void;
+    /**
+     * alias for `sidebarLayout.filters`; when supplied it wins for that rail and still calls `onRightRailOpenChange`
+     */
     rightRailOpen?: boolean;
     onRightRailOpenChange?: (open: boolean) => void;
     /**
@@ -227,13 +280,28 @@ export type TranscriptViewerProps = {
      */
     showOutcome?: boolean;
     /**
-     * default false: render a `search this transcript` button at the end of the tab strip that opens search exactly as ⌘F does; independent of `showTail`
+     * default false: render a `search transcript` button at the end of the session views in the bottom bar that opens search exactly as ⌘F does; independent of `showTail`
      */
     showSearchTrigger?: boolean;
+    /**
+     * default omitted: both stay off. `hints` renders the shortcut line, `progress` the visible-turn position counter, in the bottom bar beside the session views. A host opts in per part, so a reading surface can stay quiet without losing the views. The shortcut hint is keyboard-only, so it leaves a coarse pointer below the phone breakpoint; the counter exists only on the trace view in list mode with a visible turn. The session views themselves live in the bottom bar, after the panel in DOM order, which is why the viewer opens with a `skip to session views` control
+     */
+    footer?: {
+        hints?: boolean;
+        progress?: boolean;
+    };
     /**
      * default 2: the transcript's title is an h2 in a host page; 1 when the host mounts the viewer as the whole page, so the title is the page's h1 and the phase and turn headings move up one level
      */
     headingLevel?: 1 | 2;
+    /**
+     * chrome presentation; defaults to 'classic'. `ledger` adds a subtitle slot, swaps the pinned header's provider/model + scrubber for the title + visible-turns minimap (the turns currently in view), and renders user-turn task cards in the left rail; it also rebuilds every turn as a role-led line (square role well, the role word, the turn number, the time, and the copy anchor) with prose first and one grouped work panel over the turn's tool calls, collapses a system turn to a single compact row. In that head the built-in collapse control, label affordance, model name, error chip, token badge, and saved-label chip are intentionally hidden for now, while a host's own `renderTurnActions` and `renderTurnPanel` keep rendering on every role. Omitting it renders the classic surface unchanged, and an unrecognized runtime value fails closed to classic
+     */
+    presentation?: Presentation;
+    /**
+     * optional deck under the session title; rendered in either presentation when supplied
+     */
+    subtitle?: import("react").ReactNode;
     /**
      * host-owned node rendered under the meta row (a pull request list and its own "show all" control); omitted renders nothing
      */

package/dist/lib/types/transcript/work-summary.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Summarize one turn's tool calls.
+ * @param {ToolCallVM[]} [tools]
+ * @returns {WorkSummary}
+ */
+export function workSummary(tools?: ToolCallVM[]): WorkSummary;
+/**
+ * The panel's leading count: "4 commands, 3 files, 1 edit"; zero parts are omitted and a turn
+ * with no commands, files or edits falls back to "N calls".
+ * @param {Partial<WorkSummary>} [summary]
+ * @returns {string}
+ */
+export function workCountLabel(summary?: Partial<WorkSummary>): string;
+/**
+ * The panel's trailing meta: "8 calls, 1 failed, 29s". The failure count is omitted when zero and
+ * the duration is omitted when nothing was recorded. The leading call count is omitted when the
+ * count label already fell back to it (no commands, files or edits).
+ * @param {Partial<WorkSummary>} [summary]
+ * @returns {string}
+ */
+export function workMetaLabel(summary?: Partial<WorkSummary>): string;
+export type ToolCallVM = import("./view-model.js").ToolCallVM;
+/**
+ * The counts one turn's work panel shows.
+ */
+export type WorkSummary = {
+    /**
+     * every tool the turn ran
+     */
+    calls: number;
+    /**
+     * `bash` group calls
+     */
+    commands: number;
+    /**
+     * distinct non-empty file paths the turn touched
+     */
+    files: number;
+    /**
+     * `edits` group calls
+     */
+    edits: number;
+    /**
+     * errored tools plus non-zero exit codes
+     */
+    failed: number;
+    /**
+     * sum of the finite recorded durations
+     */
+    durationMs: number;
+};