import { type QueryKey } from "@tanstack/react-query";
import { type Location, type NavigateOptions } from "react-router";
import { type AgentChatViewTransitionOptions } from "./chat-view-transition.js";
export interface SemanticNavigationCommandEnvelope<NavigateCommand> {
    key: string;
    command: NavigateCommand;
}
export interface UseSemanticNavigationStateOptions<NavigationState, NavigateCommand = NavigationState> {
    state: NavigationState | null | undefined;
    navigationKeys?: readonly string[];
    commandKeys?: readonly string[];
    browserTabId?: string;
    commandQueryKey?: QueryKey;
    requestSource?: string;
    commandRefetchInterval?: number | false;
    enabled?: boolean;
    keepalive?: boolean;
    writeDebounceMs?: number;
    getCommandDedupKey?: (command: NavigateCommand) => string;
    onCommand: (command: NavigateCommand) => void | Promise<void>;
    onError?: (error: unknown) => void;
}
export interface UseSemanticNavigationStateResult<NavigationState, NavigateCommand = NavigationState> {
    navigationState: NavigationState | null;
    command: SemanticNavigationCommandEnvelope<NavigateCommand> | null | undefined;
    commandQueryKey: QueryKey;
    clearCommand: () => Promise<void>;
}
export interface AgentRouteLocation {
    pathname: string;
    search: string;
    hash: string;
    searchParams: URLSearchParams;
    location: Location;
}
export interface WorkspaceAppRouteTarget {
    type: "workspace-app";
    path: string;
}
export type AgentRouteTarget = string | WorkspaceAppRouteTarget;
export interface UseAgentRouteStateOptions<NavigationState, NavigateCommand = NavigationState> {
    getNavigationState: (location: AgentRouteLocation) => NavigationState | null | undefined;
    getCommandPath: (command: NavigateCommand) => AgentRouteTarget | null | undefined;
    navigationKey?: string;
    commandKey?: string;
    browserTabId?: string;
    requestSource?: string;
    writeGlobalNavigation?: boolean;
    readGlobalCommandFallback?: boolean;
    commandQueryKey?: QueryKey;
    refetchInterval?: number | false;
    enabled?: boolean;
    keepalive?: boolean;
    writeDebounceMs?: number;
    getCommandDedupKey?: (command: NavigateCommand) => string;
    navigateOptions?: NavigateOptions | ((command: NavigateCommand) => NavigateOptions | undefined);
    agentChatViewTransition?: boolean | AgentChatViewTransitionOptions | ((command: NavigateCommand, path: string) => boolean | AgentChatViewTransitionOptions | undefined);
    onNavigate?: (command: NavigateCommand, path: string) => void;
    onError?: (error: unknown) => void;
}
export interface UseAgentRouteStateResult<NavigationState, NavigateCommand = NavigationState> extends UseSemanticNavigationStateResult<NavigationState, NavigateCommand> {
}
export declare function useSemanticNavigationState<NavigationState, NavigateCommand = NavigationState>(options: UseSemanticNavigationStateOptions<NavigationState, NavigateCommand>): UseSemanticNavigationStateResult<NavigationState, NavigateCommand>;
export declare function useAgentRouteState<NavigationState, NavigateCommand = NavigationState>(options: UseAgentRouteStateOptions<NavigationState, NavigateCommand>): UseAgentRouteStateResult<NavigationState, NavigateCommand>;