import { type UseQueryOptions, type UseQueryResult } from '@tanstack/react-query';
import type { ListOptions, WorkspaceFile } from '../workspace/types.js';
export interface UseWorkspaceListOptions extends ListOptions {
    /**
     * Pass-through to TanStack Query. Useful overrides:
     *   - `refetchOnWindowFocus: false` to opt out of the default focus-refetch
     *   - `enabled: false` for lazy/manual fetching
     *   - `staleTime: ms` for custom freshness window
     *
     * `queryKey` and `queryFn` are managed by the hook and cannot be overridden.
     */
    queryOptions?: Omit<UseQueryOptions<WorkspaceFile[], Error>, 'queryKey' | 'queryFn'>;
}
/**
 * Subscribe to a directory listing with TanStack Query cache + automatic
 * invalidation by the mutation hooks.
 *
 * Consumer must wrap the tree in `<QueryClientProvider>`. The hook reads
 * `workspaceProvider` from `<ChatProvider>` context and throws if none is
 * wired (matching `useWorkspaceFiles`'s behavior).
 *
 * For simpler use cases without cache concerns, the existing
 * `useWorkspaceFiles` hook remains available.
 */
export declare function useWorkspaceList(options?: UseWorkspaceListOptions): UseQueryResult<WorkspaceFile[], Error>;
//# sourceMappingURL=use-workspace-list.d.ts.map