@kortix/ui 0.14.8 → 0.14.9

package/dist/workspace/spaces/space-threads-tab.js

@@ -0,0 +1,156 @@
+'use client';
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
+import { ChatsCircleIcon, FunnelSimpleIcon, MagnifyingGlassIcon, XIcon } from '@phosphor-icons/react';
+import { useEffect, useMemo, useState } from 'react';
+import { useTranslations } from '../../i18n/index.js';
+import { Close } from '../../icons/close.js';
+import { AgentMark } from '../../internal/components/agent-mark.js';
+import { useSessionNeedsYouCounts } from '../../internal/hooks/use-review-session-summary.js';
+import { useDebounce } from '../../internal/hooks/use-debounced-value.js';
+import { Button } from '../../primitives/button.js';
+import { DropdownMenu, DropdownMenuContent, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, } from '../../primitives/dropdown-menu.js';
+import { EmptyArt } from '../../primitives/empty-art.js';
+import { EmptyState } from '../../primitives/empty-state.js';
+import { InputGroupSearch, InputGroupSearchIcon, InputGroupSearchInput, } from '../../primitives/input-group.js';
+import { UserAvatar } from '../../primitives/user-avatar.js';
+import { useUiViewerId } from '../../providers/ui-provider.js';
+import { participantLabel } from '../../session/participants/session-participants.js';
+import { SessionStatusMark } from '../sidebar/session-status-mark.js';
+import { agentLabel, spaceRoster, THREAD_ACTIVITIES, THREAD_STATUSES, threadActivitySince, threadFiltersFromParams, threadStatus, } from './space-timeline.js';
+import { SpaceThreadList, useSpaceThreads } from './space-timeline-view.js';
+/** Milliseconds between the last keystroke and the server search. */
+const SEARCH_DEBOUNCE_MS = 250;
+/** Shorter queries do not search: one letter matches nearly every thread. */
+const SEARCH_MIN_CHARS = 2;
+/** The URL keys of the search and the filters. */
+const FILTER_PARAMS = ['q', 'status', 'by', 'agent', 'active'];
+/** The radio value of a facet's "Any" row (Radix needs a non-empty value). */
+const ANY = 'any';
+/** The session list's mark for each Status value, so a row and its filter look the same. */
+const STATUS_MARK = {
+    working: 'running',
+    'needs-you': 'needs-you',
+    failed: 'failed',
+    done: 'done',
+};
+const STATUS_KEY = { working: 'working', 'needs-you': 'needsYou', failed: 'failed', done: 'done' };
+/**
+ * The Threads tab of a channel or DM: a search over titles and first prompts,
+ * one Filter menu (Status, Started by, Agent, Activity), the active filters
+ * as removable tokens, and the rows. Search, person, agent and activity run
+ * on the server; Status reads the loaded rows, as on the Sessions page. The
+ * URL holds every value (`?q=&status=&by=&agent=&active=`).
+ */
+export function SpaceThreadsTab({ projectId, space, threads, selectedId, onOpenThread, params, setParams, }) {
+    const t = useTranslations('spaces.view');
+    const tf = useTranslations('spaces.view.threadFilter');
+    const viewerId = useUiViewerId();
+    const filters = threadFiltersFromParams(params, space.kind);
+    const setParam = (key, value) => setParams((next) => (value ? next.set(key, value) : next.delete(key)));
+    const updatedAfter = useMemo(() => (filters.active ? threadActivitySince(filters.active, new Date()) : undefined), [filters.active]);
+    const filtered = useProjectThreads(projectId, space, filters, updatedAfter);
+    const needsYou = useSessionNeedsYouCounts(projectId);
+    const rows = useMemo(() => filters.status
+        ? filtered.sessions.filter((session) => threadStatus(session, needsYou[session.session_id]) === filters.status)
+        : filtered.sessions, [filtered.sessions, filters.status, needsYou]);
+    const roster = useMemo(() => spaceRoster(threads.sessions, space.dm_agent_name), [threads.sessions, space.dm_agent_name]);
+    const people = roster.people.filter((person) => person.id !== viewerId);
+    const personName = (id) => {
+        const person = roster.people.find((candidate) => candidate.id === id);
+        const row = filtered.sessions.find((session) => session.created_by === id);
+        return (participantLabel({ name: person?.name ?? row?.owner_name ?? null, email: person?.email ?? row?.owner_email ?? null }) ||
+            t('authorFallback'));
+    };
+    const statusLabel = (status) => tf(`statusValue.${STATUS_KEY[status]}`);
+    const activityLabel = (active) => tf(`activityValue.${active}`);
+    const byLabel = (by) => (by === 'me' || by === viewerId ? tf('me') : personName(by));
+    const tokens = [];
+    if (filters.status) {
+        tokens.push({
+            key: 'status',
+            facet: tf('status'),
+            label: statusLabel(filters.status),
+            icon: _jsx(SessionStatusMark, { status: STATUS_MARK[filters.status] }),
+        });
+    }
+    if (filters.by)
+        tokens.push({ key: 'by', facet: tf('startedBy'), label: byLabel(filters.by) });
+    if (filters.agent) {
+        tokens.push({
+            key: 'agent',
+            facet: tf('agent'),
+            label: agentLabel(filters.agent),
+            icon: _jsx(AgentMark, { slug: filters.agent, size: 14 }),
+        });
+    }
+    if (filters.active)
+        tokens.push({ key: 'active', facet: tf('activity'), label: activityLabel(filters.active) });
+    const filtering = tokens.length > 0 || filters.q.length >= SEARCH_MIN_CHARS;
+    const clearAll = () => setParams((next) => FILTER_PARAMS.forEach((key) => next.delete(key)));
+    return (_jsxs("div", { className: "flex min-h-0 flex-1 flex-col", children: [_jsxs("div", { className: "flex shrink-0 flex-wrap items-center gap-2 px-5 pt-3 pb-1", children: [_jsx(FilterSearch, { value: filters.q, placeholder: tf('search'), minChars: SEARCH_MIN_CHARS, onSearch: (q) => setParam('q', q || null) }), _jsx(ThreadFilterMenu, { kind: space.kind, filters: filters, people: people, agents: roster.agents, statusLabel: statusLabel, activityLabel: activityLabel, byLabel: byLabel, onChange: setParam }), _jsx(FilterTokens, { tokens: tokens, onRemove: (key) => setParam(key, null), onClear: clearAll })] }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto", children: _jsx(SpaceThreadList, { projectId: projectId, threads: filtered, sessions: rows, selectedId: selectedId, onOpenThread: onOpenThread, empty: filtering ? (_jsx(EmptyState, { className: "min-h-full", media: _jsx(EmptyArt, { icon: MagnifyingGlassIcon }), title: tf('noMatch'), description: tf('noMatchHint'), action: _jsxs(Button, { variant: "outline", size: "sm", className: "gap-1.5", onClick: clearAll, children: [_jsx(XIcon, { className: "size-3.5 shrink-0" }), tf('clearFilters')] }) })) : (_jsx(EmptyState, { className: "min-h-full", media: _jsx(EmptyArt, { icon: ChatsCircleIcon }), title: t('threadsEmptyTitle'), description: t('threadsEmpty') })) }) })] }));
+}
+/** The space's threads under the server-side filters. No filter: the Chat tab's cache entry. */
+function useProjectThreads(projectId, space, filters, updatedAfter) {
+    const by = filters.by;
+    return useSpaceThreads(projectId, space.space_id, {
+        q: filters.q.length >= SEARCH_MIN_CHARS ? filters.q : undefined,
+        startedBy: by === 'me' ? 'me' : undefined,
+        createdBy: by && by !== 'me' ? by : undefined,
+        agent: filters.agent ?? undefined,
+        updatedAfter,
+        keepPreviousData: true,
+    });
+}
+/** One quiet menu: a submenu per facet, each a single choice with "Any" first. A DM has no person or agent facet. */
+function ThreadFilterMenu({ kind, filters, people, agents, statusLabel, activityLabel, byLabel, onChange, }) {
+    const tf = useTranslations('spaces.view.threadFilter');
+    const pick = (key) => (value) => onChange(key, value === ANY ? null : value);
+    return (_jsxs(FilterMenu, { children: [_jsx(Facet, { label: tf('status'), value: filters.status ? statusLabel(filters.status) : tf('any'), children: _jsxs(DropdownMenuRadioGroup, { value: filters.status ?? ANY, onValueChange: pick('status'), children: [_jsx(DropdownMenuRadioItem, { value: ANY, children: tf('any') }), THREAD_STATUSES.map((status) => (_jsxs(DropdownMenuRadioItem, { value: status, children: [_jsx(SessionStatusMark, { status: STATUS_MARK[status] }), statusLabel(status)] }, status)))] }) }), kind === 'channel' ? (_jsx(Facet, { label: tf('startedBy'), value: filters.by ? byLabel(filters.by) : tf('anyone'), wide: true, children: _jsxs(DropdownMenuRadioGroup, { value: filters.by ?? ANY, onValueChange: pick('by'), children: [_jsx(DropdownMenuRadioItem, { value: ANY, children: tf('anyone') }), _jsx(DropdownMenuRadioItem, { value: "me", children: tf('me') }), people.length > 0 ? _jsx(DropdownMenuSeparator, {}) : null, people.map((person) => {
+                            const name = participantLabel(person);
+                            return (_jsxs(DropdownMenuRadioItem, { value: person.id, children: [_jsx(UserAvatar, { size: "xs", name: name, email: person.email ?? '', avatarUrl: person.avatarUrl }), _jsx("span", { className: "min-w-0 truncate", children: name })] }, person.id));
+                        })] }) })) : null, kind === 'channel' && (agents.length > 0 || filters.agent) ? (_jsx(Facet, { label: tf('agent'), value: filters.agent ? agentLabel(filters.agent) : tf('anyAgent'), wide: true, children: _jsxs(DropdownMenuRadioGroup, { value: filters.agent ?? ANY, onValueChange: pick('agent'), children: [_jsx(DropdownMenuRadioItem, { value: ANY, children: tf('anyAgent') }), agents.map((agent) => (_jsxs(DropdownMenuRadioItem, { value: agent, children: [_jsx(AgentMark, { slug: agent, size: 14 }), _jsx("span", { className: "min-w-0 truncate", children: agentLabel(agent) })] }, agent)))] }) })) : null, _jsx(Facet, { label: tf('activity'), value: filters.active ? activityLabel(filters.active) : tf('anyTime'), children: _jsxs(DropdownMenuRadioGroup, { value: filters.active ?? ANY, onValueChange: pick('active'), children: [_jsx(DropdownMenuRadioItem, { value: ANY, children: tf('anyTime') }), THREAD_ACTIVITIES.map((active) => (_jsx(DropdownMenuRadioItem, { value: active, children: activityLabel(active) }, active)))] }) })] }));
+}
+/**
+ * The search field of a channel tab's toolbar (Threads, Links). The text is
+ * local while typing; `onSearch` gets the settled query ('' below `minChars`),
+ * and Esc clears it. A new `value` (Clear, the back button) replaces the text.
+ */
+export function FilterSearch({ value, placeholder, minChars = 1, onSearch, }) {
+    const [text, setText] = useState(value);
+    const [seen, setSeen] = useState(value);
+    if (value !== seen) {
+        setSeen(value);
+        setText(value);
+    }
+    const debounced = useDebounce(text.trim(), SEARCH_DEBOUNCE_MS);
+    useEffect(() => {
+        const q = debounced.length >= minChars ? debounced : '';
+        if (q !== value)
+            onSearch(q);
+        // Only a settled keystroke searches; a new `value` resets `text` above.
+        // eslint-disable-next-line react-hooks/exhaustive-deps
+    }, [debounced]);
+    return (_jsxs(InputGroupSearch, { className: "max-w-64 min-w-40 flex-1", children: [_jsx(InputGroupSearchIcon, { children: _jsx(MagnifyingGlassIcon, {}) }), _jsx(InputGroupSearchInput, { size: "xs", type: "search", placeholder: placeholder, "aria-label": placeholder, value: text, onChange: (event) => setText(event.target.value), onKeyDown: (event) => {
+                    if (event.key !== 'Escape' || !text)
+                        return;
+                    event.stopPropagation();
+                    setText('');
+                    onSearch('');
+                } })] }));
+}
+/** The quiet "Filter" button and its menu; the children are `Facet` rows. */
+export function FilterMenu({ children }) {
+    const tf = useTranslations('spaces.view.threadFilter');
+    return (_jsxs(DropdownMenu, { children: [_jsx(DropdownMenuTrigger, { asChild: true, children: _jsxs(Button, { variant: "ghost", size: "sm", className: "text-muted-foreground hover:text-foreground", children: [_jsx(FunnelSimpleIcon, { className: "size-4 shrink-0" }), tf('filter')] }) }), _jsx(DropdownMenuContent, { align: "start", className: "w-56 p-1", children: children })] }));
+}
+/** The active filters as removable tokens, then Clear. */
+export function FilterTokens({ tokens, onRemove, onClear, }) {
+    const tf = useTranslations('spaces.view.threadFilter');
+    if (tokens.length === 0)
+        return null;
+    return (_jsxs(_Fragment, { children: [tokens.map((token) => (_jsxs(Button, { variant: "secondary", size: "xs", "aria-label": tf('remove', { facet: token.facet, value: token.label }), onClick: () => onRemove(token.key), className: "max-w-48 gap-1.5", children: [token.icon, _jsx("span", { className: "min-w-0 truncate", children: token.label }), _jsx(Close, { className: "text-muted-foreground size-3.5 shrink-0" })] }, token.key))), _jsx(Button, { variant: "ghost", size: "xs", onClick: onClear, className: "text-muted-foreground", children: tf('clear') })] }));
+}
+/** A facet row: its name, its current value muted on the right, its choices in a submenu. */
+export function Facet({ label, value, wide, children }) {
+    return (_jsxs(DropdownMenuSub, { children: [_jsxs(DropdownMenuSubTrigger, { children: [_jsx("span", { className: "min-w-0 flex-1 truncate", children: label }), _jsx("span", { className: "text-muted-foreground max-w-24 truncate text-xs", children: value })] }), _jsx(DropdownMenuSubContent, { className: wide ? 'max-h-80 w-56 overflow-y-auto p-1' : 'w-48 p-1', children: children })] }));
+}

package/dist/workspace/spaces/space-timeline-view.d.ts

@@ -0,0 +1,254 @@
+import type { ProjectSession, ProjectSpace } from '@kortix/sdk';
+import { type UseProjectSessionsOptions } from '@kortix/sdk/react';
+import { type ReactNode } from 'react';
+/**
+ * The space's threads: top-level sessions only (`parent: 'root'`, a child
+ * thread is part of its parent). Polls page one every 5 s while an agent works
+ * so the "is working" line settles, else every 15 s so a member's new thread
+ * shows up. Active threads sort first, so page one holds them; older pages the
+ * viewer loaded are not re-read on each tick. `filters` narrow it on the
+ * server (the Threads tab); without them it is the Chat tab's list, one cache
+ * entry for both tabs.
+ */
+export declare function useSpaceThreads(projectId: string, spaceId: string | undefined, filters?: Pick<UseProjectSessionsOptions, 'q' | 'startedBy' | 'createdBy' | 'agent' | 'updatedAfter' | 'keepPreviousData'>): {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: true;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchNextPageError: boolean;
+    isFetchingNextPage: boolean;
+    isFetchPreviousPageError: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>;
+    error: null;
+    isError: false;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: true;
+    isPlaceholderData: false;
+    status: "success";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: undefined;
+    error: Error;
+    isError: true;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: true;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "error";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoading: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: undefined;
+    error: null;
+    isError: false;
+    isPending: true;
+    isLoadingError: false;
+    isRefetchError: false;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    isSuccess: false;
+    isPlaceholderData: false;
+    status: "pending";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isLoading: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+} | {
+    isScanning: boolean;
+    sessions: ProjectSession[];
+    data: import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>;
+    isError: false;
+    error: null;
+    isPending: false;
+    isLoading: false;
+    isLoadingError: false;
+    isRefetchError: false;
+    isSuccess: true;
+    isPlaceholderData: true;
+    isFetchNextPageError: false;
+    isFetchPreviousPageError: false;
+    status: "success";
+    fetchNextPage: (options?: import("@tanstack/react-query").FetchNextPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchPreviousPage: (options?: import("@tanstack/react-query").FetchPreviousPageOptions) => Promise<import("@tanstack/react-query").InfiniteQueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    isFetchingNextPage: boolean;
+    isFetchingPreviousPage: boolean;
+    dataUpdatedAt: number;
+    errorUpdatedAt: number;
+    failureCount: number;
+    failureReason: Error | null;
+    errorUpdateCount: number;
+    isFetched: boolean;
+    isFetchedAfterMount: boolean;
+    isFetching: boolean;
+    isInitialLoading: boolean;
+    isPaused: boolean;
+    isRefetching: boolean;
+    isStale: boolean;
+    isEnabled: boolean;
+    refetch: (options?: import("@tanstack/react-query").RefetchOptions) => Promise<import("@tanstack/react-query").QueryObserverResult<import("@tanstack/react-query").InfiniteData<import("@kortix/sdk").ProjectSessionPage, unknown>, Error>>;
+    fetchStatus: import("@tanstack/react-query").FetchStatus;
+};
+export type SpaceThreads = ReturnType<typeof useSpaceThreads>;
+/**
+ * The Chat tab: the welcome block, then one row per thread, oldest at the top,
+ * grouped under day dividers. The column is reversed, so it opens scrolled to
+ * the newest thread and stays there as threads arrive.
+ */
+export declare function SpaceTimeline({ projectId, space, threads, selectedId, onOpenThread, }: {
+    projectId: string;
+    space: ProjectSpace;
+    threads: SpaceThreads;
+    selectedId: string | null;
+    onOpenThread: (sessionId: string) => void;
+}): import("react").JSX.Element;
+/**
+ * The Threads tab's rows, last activity first. `sessions` are the rows to
+ * show (the tab filters `threads`); `empty` is drawn when there are none.
+ */
+export declare function SpaceThreadList({ projectId, threads, sessions, empty, selectedId, onOpenThread, }: {
+    projectId: string;
+    threads: SpaceThreads;
+    sessions: readonly ProjectSession[];
+    empty: ReactNode;
+    selectedId: string | null;
+    onOpenThread: (sessionId: string) => void;
+}): import("react").JSX.Element | null;