@meridianlabs/inspect-scout-viewer 0.4.21 → 0.4.38

package/lib/src/app/scans/constants.d.ts

@@ -1,35 +0,0 @@
-/**
- * Infinite Scroll Tuning
- *
- * Goal: user never hits bottom while waiting for next page.
- *
- * Formula: threshold >= scroll_speed × fetch_duration
- *
- * Assumptions:
- *   row_height = 29px
- *   fetch_duration = 300-1000ms (variable with fixed overhead)
- *   max_scroll_speed = 1500px/s (typical fast scroller)
- *
- * Check at typical speed (1500px/s):
- *   runway_time = 2000px / 1500px/s = 1333ms
- *   worst_case_fetch = 1000ms
- *   margin = 333ms ✓
- *
- * Check at extreme speed (5000px/s):
- *   runway_time = 2000px / 5000px/s = 400ms
- *   median_fetch = ~350ms
- *   margin = 50ms (tight but ok) ✓
- *
- * Why large pageSize? Fetch duration is mostly fixed overhead, so larger
- * pages = fewer fetches = fewer stall opportunities. 500 rows gives ~9.7s
- * of scrolling per page at 1500px/s.
- *
- * Note: If threshold > pageSize_px, the next page is prefetched immediately
- * after the current page loads. This is fine for maximum smoothness.
- */
-export declare const SCANS_INFINITE_SCROLL_CONFIG: {
-    /** Number of rows to fetch per page (500 rows = 14,500px at 29px/row) */
-    readonly pageSize: 500;
-    /** Distance from bottom (in px) at which to trigger fetch (~69 rows) */
-    readonly threshold: 2000;
-};

package/lib/src/app/server/index.d.ts

@@ -1,6 +0,0 @@
-import { SortingState } from '@tanstack/react-table';
-import { OrderByModel } from '../../query';
-export declare const sortingStateToOrderBy: (sorting: SortingState) => OrderByModel[];
-export type CursorType = {
-    [key: string]: unknown;
-};

package/lib/src/app/server/useActiveScan.d.ts

@@ -1,3 +0,0 @@
-import { ActiveScanInfo } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useActiveScan: (scanId: string | undefined) => AsyncData<ActiveScanInfo | undefined>;

package/lib/src/app/server/useActiveScans.d.ts

@@ -1,3 +0,0 @@
-import { ActiveScanInfo } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useActiveScans: () => AsyncData<Record<string, ActiveScanInfo>>;

package/lib/src/app/server/useAdjacentTranscriptIds.d.ts

@@ -1,10 +0,0 @@
-import { SortingState } from '@tanstack/react-table';
-import { Condition } from '../../query';
-import { AsyncData } from '../../utils/asyncData';
-/**
- * Returns prev/next transcript IDs relative to the given ID.
- *
- * Note: prev is undefined when viewing the first loaded item.
- * Reverse paging not yet supported - will need backend prev_cursor.
- */
-export declare const useAdjacentTranscriptIds: (id: string, location?: string | null, pageSize?: number, filter?: Condition, sorting?: SortingState) => AsyncData<[string | undefined, string | undefined]>;

package/lib/src/app/server/useAppConfig.d.ts

@@ -1,20 +0,0 @@
-import { AppConfig } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-/**
- * Loads app config asynchronously at app initialization.
- *
- * Use this hook only at the top of the app before rendering to load config
- * data globally. After this completes, all other components should use
- * useConfig to access the loaded value synchronously.
- */
-export declare const useAppConfigAsync: () => AsyncData<AppConfig>;
-/**
- * Returns app config for use in components after data loaded globally.
- *
- * Use this hook in regular components throughout the app. Assumes the async
- * data has already been loaded at app initialization via useConfigAsync.
- * Throws if data not yet available.
- */
-export declare const useAppConfig: () => AppConfig;
-export declare function appAliasedPath(appConfig: AppConfig, path: string | null): string | null;
-export declare function projectOrAppAliasedPath(appConfig: AppConfig, path: string | null): string | null;

package/lib/src/app/server/useCode.d.ts

@@ -1,4 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { Condition } from '../../query/types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useCode: (condition: Condition | typeof skipToken) => AsyncData<Record<string, string>>;

package/lib/src/app/server/useHasTranscript.d.ts

@@ -1,8 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { AsyncData } from '../../utils/asyncData';
-type HasTranscriptParams = {
-    location: string;
-    id: string;
-};
-export declare const useHasTranscript: (params: HasTranscriptParams | typeof skipToken) => AsyncData<boolean>;
-export {};

package/lib/src/app/server/useProjectConfig.d.ts

@@ -1,30 +0,0 @@
-import { DefaultError, UseMutationResult } from '@tanstack/react-query';
-import { ProjectConfig, ProjectConfigInput } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export type ProjectConfigWithEtag = {
-    config: ProjectConfig;
-    etag: string;
-};
-/**
- * Loads project configuration from scout.yaml.
- *
- * Returns both the config and an etag for optimistic concurrency control.
- *
- * Automatic refetching is disabled to support optimistic locking:
- * - External changes are detected via etag mismatch on save (412 error)
- * - User explicitly chooses to reload or force save on conflict
- */
-export declare const useProjectConfig: () => AsyncData<ProjectConfigWithEtag>;
-/**
- * Mutation hook for updating project configuration.
- *
- * Updates scout.yaml while preserving comments and formatting.
- * Requires the current etag for optimistic concurrency control.
- *
- * On success, updates the query cache with the new config and etag.
- * On 412 Precondition Failed, the config was modified externally.
- */
-export declare const useUpdateProjectConfig: () => UseMutationResult<ProjectConfigWithEtag, DefaultError, {
-    config: ProjectConfigInput;
-    etag: string | null;
-}>;

package/lib/src/app/server/useScan.d.ts

@@ -1,9 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { Status } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-type ScanParams = {
-    scansDir: string;
-    scanPath: string;
-};
-export declare const useScan: (params: ScanParams | typeof skipToken) => AsyncData<Status>;
-export {};

package/lib/src/app/server/useScanDataframe.d.ts

@@ -1,10 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { ColumnTable } from 'arquero';
-import { AsyncData } from '../../utils/asyncData';
-type ScanDataframeParams = {
-    scansDir: string;
-    scanPath: string;
-    scanner: string;
-};
-export declare const useScanDataframe: (params: ScanDataframeParams | typeof skipToken) => AsyncData<ColumnTable>;
-export {};

package/lib/src/app/server/useScanDataframeInput.d.ts

@@ -1,11 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { ScannerInput } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-type ScanDataframeInputParams = {
-    scansDir: string;
-    scanPath: string;
-    scanner: string;
-    uuid: string;
-};
-export declare const useScanDataframeInput: (params: ScanDataframeInputParams | typeof skipToken) => AsyncData<ScannerInput>;
-export {};

package/lib/src/app/server/useScanners.d.ts

@@ -1,3 +0,0 @@
-import { ScannerInfo } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useScanners: () => AsyncData<ScannerInfo[]>;

package/lib/src/app/server/useScans.d.ts

@@ -1,3 +0,0 @@
-import { ScanRow } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useScans: (scansDir: string) => AsyncData<ScanRow[]>;

package/lib/src/app/server/useScansColumnValues.d.ts

@@ -1,11 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { ScalarValue } from '../../api/api';
-import { Condition } from '../../query';
-import { AsyncData } from '../../utils/asyncData';
-type ScansColumnValuesParams = {
-    location: string;
-    column: string;
-    filter: Condition | undefined;
-};
-export declare const useScansColumnValues: (params: ScansColumnValuesParams | typeof skipToken) => AsyncData<ScalarValue[]>;
-export {};

package/lib/src/app/server/useScansInfinite.d.ts

@@ -1,6 +0,0 @@
-import { UseInfiniteQueryResult, InfiniteData } from '@tanstack/react-query';
-import { SortingState } from '@tanstack/react-table';
-import { Condition } from '../../query';
-import { ScansResponse } from '../../types/api-types';
-import { CursorType } from '.';
-export declare const useScansInfinite: (scansDir: string, pageSize?: number, filter?: Condition, sorting?: SortingState) => UseInfiniteQueryResult<InfiniteData<ScansResponse, CursorType | undefined>, Error>;

package/lib/src/app/server/useServerTranscripts.d.ts

@@ -1,5 +0,0 @@
-import { SortingState } from '@tanstack/react-table';
-import { Condition } from '../../query';
-import { TranscriptsResponse } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-export declare const useServerTranscripts: (location: string, filter?: Condition, sorting?: SortingState) => AsyncData<TranscriptsResponse>;

package/lib/src/app/server/useServerTranscriptsInfinite.d.ts

@@ -1,13 +0,0 @@
-import { UseInfiniteQueryResult, InfiniteData, skipToken } from '@tanstack/react-query';
-import { SortingState } from '@tanstack/react-table';
-import { Condition } from '../../query';
-import { TranscriptsResponse } from '../../types/api-types';
-import { CursorType } from '.';
-type ServerTranscriptsInfiniteParams = {
-    location: string;
-    pageSize?: number;
-    filter?: Condition;
-    sorting?: SortingState;
-};
-export declare const useServerTranscriptsInfinite: (params: ServerTranscriptsInfiniteParams | typeof skipToken) => UseInfiniteQueryResult<InfiniteData<TranscriptsResponse, CursorType | undefined>, Error>;
-export {};

package/lib/src/app/server/useStartScan.d.ts

@@ -1,3 +0,0 @@
-import { DefaultError, UseMutationResult } from '@tanstack/react-query';
-import { ScanJobConfig, Status } from '../../types/api-types';
-export declare const useStartScan: () => UseMutationResult<Status, DefaultError, ScanJobConfig>;

package/lib/src/app/server/useTopicInvalidation.d.ts

@@ -1,11 +0,0 @@
-/**
- * Monitors topic updates via SSE and invalidates dependent queries on change.
- *
- * For each topic whose timestamp changes, invalidates all queries containing
- * that topic name in their query key.
- *
- * Call once at app root level.
- *
- * @returns true when first SSE message received (ready), false otherwise
- */
-export declare const useTopicInvalidation: () => boolean;

package/lib/src/app/server/useTranscript.d.ts

@@ -1,9 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { Transcript } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-type TranscriptParams = {
-    location: string;
-    id: string;
-};
-export declare const useTranscript: (params: TranscriptParams | typeof skipToken) => AsyncData<Transcript>;
-export {};

package/lib/src/app/server/useTranscriptsColumnValues.d.ts

@@ -1,11 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { ScalarValue } from '../../api/api';
-import { Condition } from '../../query';
-import { AsyncData } from '../../utils/asyncData';
-type TranscriptsColumnValuesParams = {
-    location: string;
-    column: string;
-    filter: Condition | undefined;
-};
-export declare const useTranscriptsColumnValues: (params: TranscriptsColumnValuesParams | typeof skipToken) => AsyncData<ScalarValue[]>;
-export {};

package/lib/src/app/server/useValidations.d.ts

@@ -1,83 +0,0 @@
-import { skipToken } from '@tanstack/react-query';
-import { ValidationCase, ValidationCaseRequest } from '../../types/api-types';
-import { AsyncData } from '../../utils/asyncData';
-/**
- * Query key factory for validation-related queries.
- * Centralizes key definitions to ensure consistency between queries and invalidations.
- */
-export declare const validationQueryKeys: {
-    sets: () => readonly ["validationSets"];
-    cases: (uri: string | typeof skipToken) => readonly ["validationCases", string | typeof skipToken];
-    case: (params: {
-        url: string;
-        caseId: string;
-    } | typeof skipToken) => readonly ["validationCase", typeof skipToken | {
-        url: string;
-        caseId: string;
-    }];
-};
-/**
- * Hook to fetch all validation set URIs in the project.
- */
-export declare const useValidationSets: () => AsyncData<string[]>;
-/**
- * Hook to fetch validation cases for a specific validation set.
- */
-export declare const useValidationCases: (uri: string | typeof skipToken) => AsyncData<ValidationCase[]>;
-/**
- * Hook to fetch a single validation case by URI and case ID.
- * Returns null (not an error) when the case is not found (404).
- */
-export declare const useValidationCase: (params: {
-    url: string;
-    caseId: string;
-} | typeof skipToken) => AsyncData<ValidationCase | null>;
-/**
- * Hook to create a new validation set.
- */
-export declare const useCreateValidationSet: () => import('@tanstack/react-query').UseMutationResult<string, Error, {
-    cases: import('../../types/generated').components["schemas"]["ValidationCaseRequest"][];
-    path: string;
-}, unknown>;
-/**
- * Hook to update a validation case (upsert).
- * Uses optimistic updates to prevent UI flicker during save.
- */
-export declare const useUpdateValidationCase: (uri: string) => import('@tanstack/react-query').UseMutationResult<{
-    id: string | string[];
-    labels: {
-        [key: string]: boolean;
-    } | null;
-    predicate?: ("gt" | "gte" | "lt" | "lte" | "eq" | "ne" | "contains" | "startswith" | "endswith" | "icontains" | "iequals") | null;
-    split?: string | null;
-    target?: import('../../types/generated').components["schemas"]["JsonValue"] | null;
-}, Error, {
-    caseId: string;
-    data: ValidationCaseRequest;
-}, {
-    previousCase: ValidationCase | undefined;
-    previousCases: ValidationCase[] | undefined;
-}>;
-/**
- * Hook to delete a single validation case.
- */
-export declare const useDeleteValidationCase: (uri: string) => import('@tanstack/react-query').UseMutationResult<void, Error, string, unknown>;
-/**
- * Hook to delete multiple validation cases (bulk delete).
- * Uses Promise.allSettled to handle partial failures gracefully.
- */
-export declare const useBulkDeleteValidationCases: (uri: string) => import('@tanstack/react-query').UseMutationResult<{
-    succeeded: number;
-    failed: number;
-}, Error, string[], unknown>;
-/**
- * Hook to delete an entire validation set.
- */
-export declare const useDeleteValidationSet: () => import('@tanstack/react-query').UseMutationResult<void, Error, string, unknown>;
-/**
- * Hook to rename a validation set.
- */
-export declare const useRenameValidationSet: () => import('@tanstack/react-query').UseMutationResult<string, Error, {
-    uri: string;
-    newName: string;
-}, unknown>;

package/lib/src/app/timeline/components/TimelineEventsView.d.ts

@@ -1,41 +0,0 @@
-import { FC, RefObject } from 'react';
-import { Event, ServerTimeline } from '../../../types/api-types';
-import { TimelineOptions } from '../hooks/useTimeline';
-import { MarkerConfig } from '../utils/markers';
-interface TimelineEventsViewProps {
-    /** Raw events to display. Runs the full timeline pipeline internally. */
-    events: Event[];
-    /** Scroll container for StickyScroll and virtual list. */
-    scrollRef: RefObject<HTMLDivElement | null>;
-    /** Base offset for sticky positioning (e.g. tab bar height). Default: 0. */
-    offsetTop?: number;
-    /** Deep-link to a specific event on mount. */
-    initialEventId?: string | null;
-    /** Deep-link to a message ID, resolved to the best matching event. */
-    initialMessageId?: string | null;
-    /** Initial outline state when no persistent preference exists. Default: false (collapsed). */
-    defaultOutlineExpanded?: boolean;
-    /** Unique ID for the virtual list. */
-    id: string;
-    /** Bulk collapse/expand of all collapsible events. undefined = no-op. */
-    collapsed?: boolean;
-    /** Called when a marker (error, compaction) is clicked on the swimlane.
-     *  Optional `selectedKey` requests the bar be selected atomically with navigation. */
-    onMarkerNavigate?: (eventId: string, selectedKey?: string) => void;
-    /** Controls which marker kinds are shown and at what depth. */
-    markerConfig?: MarkerConfig;
-    /** Controls swimlane visibility. `"auto"` shows when data has child spans. Default: `"auto"`. */
-    timeline?: true | false | "auto";
-    /** Controls which agents are included in the timeline. */
-    agentConfig?: TimelineOptions;
-    /** Server-provided timelines (used when available instead of building from events). */
-    timelines?: ServerTimeline[];
-    /** Headroom direction signal: true = scrolling down (hide). */
-    headroomHidden?: boolean;
-    /** Reset the headroom anchor before a layout shift or programmatic scroll.
-     *  Pass `true` to debounce (keeps lock alive while scrolling continues). */
-    onHeadroomResetAnchor?: (debounce?: boolean) => void;
-    className?: string;
-}
-export declare const TimelineEventsView: FC<TimelineEventsViewProps>;
-export {};

package/lib/src/app/timeline/components/TimelineMinimap.d.ts

@@ -1,30 +0,0 @@
-import { FC } from 'react';
-import { TimelineSpan } from '../../../components/transcript/timeline';
-import { TimeMapping } from '../utils/timeMapping';
-export interface MinimapSelection {
-    startTime: Date;
-    endTime: Date;
-    totalTokens: number;
-}
-export interface TimelineMinimapProps {
-    /** Root timeline span (always the full timeline). */
-    root: TimelineSpan;
-    /** Currently selected swimlane row, if any. */
-    selection?: MinimapSelection;
-    /** Time mapping for the root node (compresses gaps if present). */
-    mapping?: TimeMapping;
-    /** Scroll progress within the event list (0–1).
-     *  Positioned as a fraction of the selection bar.
-     *  `null` or `undefined` = no scrubber shown. */
-    scrubberProgress?: number | null;
-    /** Called when the user clicks or drags on the selection region.
-     *  `progress` is 0–1 representing the target scroll position. */
-    onScrub?: (progress: number) => void;
-}
-/**
- * Compact minimap showing the selected row's position within the full timeline.
- *
- * Renders as a self-contained flex row: mode label + bar area.
- * Designed to sit inside the breadcrumb row, right-aligned.
- */
-export declare const TimelineMinimap: FC<TimelineMinimapProps>;

package/lib/src/app/timeline/components/TimelineOptionsPopover.d.ts

@@ -1,10 +0,0 @@
-import { FC } from 'react';
-import { UseTimelineConfigResult } from '../hooks/useTimelineConfig';
-interface TimelineOptionsPopoverProps {
-    isOpen: boolean;
-    setIsOpen: (open: boolean) => void;
-    positionEl: HTMLElement | null;
-    config: UseTimelineConfigResult;
-}
-export declare const TimelineOptionsPopover: FC<TimelineOptionsPopoverProps>;
-export {};

package/lib/src/app/timeline/components/TimelineSelector.d.ts

@@ -1,11 +0,0 @@
-import { FC } from 'react';
-import { Timeline } from '../../../components/transcript/timeline';
-export interface TimelineSelectorProps {
-    /** Available timeline views. */
-    timelines: ReadonlyArray<Timeline>;
-    /** Index of the active timeline. */
-    activeIndex: number;
-    /** Called when a timeline is selected. */
-    onSelect: (index: number) => void;
-}
-export declare const TimelineSelector: FC<TimelineSelectorProps>;

package/lib/src/app/timeline/components/TimelineSwimLanes.d.ts

@@ -1,62 +0,0 @@
-import { FC } from 'react';
-import { TimelineState } from '../hooks/useTimeline';
-import { UseTimelineConfigResult } from '../hooks/useTimelineConfig';
-import { RowLayout } from '../utils/swimlaneLayout';
-import { TimelineMinimapProps } from './TimelineMinimap';
-import { TimelineSelectorProps } from './TimelineSelector';
-export interface BreadcrumbSegment {
-    /** Display name for this segment. */
-    label: string;
-    /** Selection key to navigate to this segment. */
-    key: string;
-}
-/**
- * Builds breadcrumb segments from the layouts and selected key.
- *
- * The selected key encodes tree position (e.g. "transcript/build/test").
- * We find ancestor rows by matching prefix keys, producing a trail like:
- * [main, Build, Test] where "Test" is the currently selected row.
- */
-export declare function buildBreadcrumbs(layouts: RowLayout[], selectedRowKey: string | null): BreadcrumbSegment[];
-/** Navigation subset of TimelineState needed by the swimlane component. */
-export type TimelineNavigation = Pick<TimelineState, "node" | "selected" | "select" | "clearSelection">;
-/** Header configuration: root label + optional minimap + breadcrumbs. */
-export interface TimelineHeaderProps {
-    rootLabel: string;
-    /** Called on header click to scroll the view to the top. */
-    onScrollToTop?: () => void;
-    /** Minimap props for the zoom indicator. */
-    minimap?: TimelineMinimapProps;
-    /** Breadcrumb segments derived from the selected row's ancestry. */
-    breadcrumbs?: BreadcrumbSegment[];
-    /** Called when a breadcrumb segment is clicked. */
-    onBreadcrumbSelect?: (key: string) => void;
-    /** Timeline config for the options popover. When provided, shows the options button. */
-    timelineConfig?: UseTimelineConfigResult;
-    /** Timeline selector for switching between multiple timelines. */
-    timelineSelector?: TimelineSelectorProps;
-}
-interface TimelineSwimLanesProps {
-    /** Row layouts computed by computeRowLayouts. */
-    layouts: RowLayout[];
-    /** Timeline navigation state (selection). */
-    timeline: TimelineNavigation;
-    /** Header configuration. */
-    header?: TimelineHeaderProps;
-    /** Whether the swimlane is currently in sticky mode (opaque background). */
-    isSticky?: boolean;
-    /** Called when an error or compaction marker is clicked. */
-    onMarkerNavigate?: (eventId: string, selectedKey?: string) => void;
-    /** Headroom auto-collapse: true when scrolling down while sticky. */
-    headroomCollapsed?: boolean;
-    /** Called before a layout shift (toggle) so the headroom hook can reset
-     *  its anchor and ignore the resulting scroll-position change. */
-    onLayoutShift?: () => void;
-    /** Map from row key → number of compaction regions (only for rows with compactions). */
-    regionCounts?: ReadonlyMap<string, number>;
-    /** Default collapsed state when user has no stored preference.
-     *  Falls back to `isFlat` (layouts.length <= 1) when undefined. */
-    defaultCollapsed?: boolean;
-}
-export declare const TimelineSwimLanes: FC<TimelineSwimLanesProps>;
-export {};

package/lib/src/app/timeline/contentItems.d.ts

@@ -1,29 +0,0 @@
-import { TimelineBranch, TimelineEvent, TimelineSpan } from '../../components/transcript/timeline';
-export interface EventItem {
-    type: "event";
-    eventNode: TimelineEvent;
-}
-export interface AgentCardItem {
-    type: "agent_card";
-    agentNode: TimelineSpan;
-}
-export interface BranchCardItem {
-    type: "branch_card";
-    branch: TimelineBranch;
-}
-export type ContentItem = EventItem | AgentCardItem | BranchCardItem;
-/**
- * Builds a flat list of content items from a TimelineSpan.
- *
- * Walks the span's content chronologically, converting each child to either
- * an event item or agent card. Then inserts branch cards after the event
- * whose UUID matches `branch.forkedAt`. Branches with unresolvable UUIDs
- * are appended at the end.
- *
- * When `includeUtility` is false (default), utility spans are filtered out —
- * they represent internal model calls (e.g. file path extraction) that should
- * not appear in the UI.
- */
-export declare function buildContentItems(node: TimelineSpan, options?: {
-    includeUtility?: boolean;
-}): ContentItem[];

package/lib/src/app/timeline/hooks/useActiveTimeline.d.ts

@@ -1,12 +0,0 @@
-import { Timeline } from '../../../components/transcript/timeline';
-export interface UseActiveTimelineResult {
-    /** The currently active Timeline. */
-    active: Timeline;
-    /** 0-based index of the active timeline. */
-    activeIndex: number;
-    /** Switch to a different timeline by index. Resets selection. */
-    setActive: (index: number) => void;
-    /** All available timelines. */
-    timelines: Timeline[];
-}
-export declare function useActiveTimeline(timelines: Timeline[]): UseActiveTimelineResult;

package/lib/src/app/timeline/hooks/useScrubberPercent.d.ts

@@ -1,8 +0,0 @@
-/**
- * Returns the scroll progress (0–1) within the virtual event list.
- *
- * The minimap uses this to position the scrubber as a fraction of the
- * selection bar — completely decoupled from event timestamps, which are
- * non-monotonic in the depth-first flattened list.
- */
-export declare function useScrubberProgress(listKey: string): number | null;

package/lib/src/app/timeline/hooks/useTimeline.d.ts

@@ -1,46 +0,0 @@
-import { Timeline, TimelineBranch, TimelineSpan } from '../../../components/transcript/timeline';
-import { SwimlaneRow } from '../utils/swimlaneRows';
-export interface TimelineState {
-    /** The root TimelineSpan (always the timeline root). */
-    node: TimelineSpan;
-    /** Flat swimlane rows for all descendants. */
-    rows: SwimlaneRow[];
-    /** Currently selected row key, or null. */
-    selected: string | null;
-    /** Select a row by key, or null to clear. */
-    select: (key: string | null) => void;
-    /** Clear the selection (returns to default root selection). */
-    clearSelection: () => void;
-}
-export interface BranchLookupResult {
-    /** The span that owns the branches. */
-    owner: TimelineSpan;
-    /** Matching branches with their 1-indexed position. */
-    branches: Array<{
-        branch: TimelineBranch;
-        index: number;
-    }>;
-}
-/**
- * Finds all branches matching a forkedAt UUID anywhere in the span tree.
- * Returns the owning span and matching branches.
- */
-export declare function findBranchesByForkedAt(node: TimelineSpan, forkedAt: string): BranchLookupResult | null;
-/**
- * Creates a TimelineSpan for a branch's content (informational display).
- *
- * If the branch has exactly one child span, returns that span directly
- * (with a ↳ prefix on its name). Otherwise creates a synthetic container.
- */
-export declare function createBranchSpan(branch: TimelineBranch, index: number): TimelineSpan;
-/**
- * Timeline state hook.
- *
- * Computes a fully expanded flat list of swimlane rows from the timeline root.
- * Selection is driven by the `selected` URL search param using row keys.
- */
-export interface TimelineOptions {
-    /** Include utility agents in the swimlane rows. Default: false. */
-    includeUtility?: boolean;
-}
-export declare function useTimeline(timeline: Timeline, options?: TimelineOptions): TimelineState;

package/lib/src/app/timeline/hooks/useTimelineConfig.d.ts

@@ -1,22 +0,0 @@
-import { MarkerConfig, MarkerDepth, MarkerKind } from '../utils/markers';
-import { TimelineOptions } from './useTimeline';
-export interface UseTimelineConfigResult {
-    /** Resolved MarkerConfig for the timeline pipeline. */
-    markerConfig: MarkerConfig;
-    /** Resolved TimelineOptions for the timeline pipeline. */
-    agentConfig: TimelineOptions;
-    /** Current marker kinds selection. */
-    markerKinds: MarkerKind[];
-    /** Current marker depth selection. */
-    markerDepth: MarkerDepth;
-    /** Whether utility agents are shown. */
-    includeUtility: boolean;
-    setMarkerKinds: (kinds: MarkerKind[]) => void;
-    setMarkerDepth: (depth: MarkerDepth) => void;
-    setIncludeUtility: (include: boolean) => void;
-    toggleMarkerKind: (kind: MarkerKind) => void;
-    resetToDefaults: () => void;
-    /** True when all settings match their defaults. */
-    isDefault: boolean;
-}
-export declare function useTimelineConfig(): UseTimelineConfigResult;