import { type ZodType } from '@frontmcp/lazy-zod';
/**
 * Parse list request input and validate method.
 * Common pattern used in tools/list, resources/list, etc.
 *
 * @param rawInput - Raw input from the flow
 * @param schema - Zod schema for the input
 * @param expectedMethod - Expected MCP method (e.g., 'tools/list', 'resources/list')
 * @returns Parsed params including cursor
 */
export declare function parseListInput<T extends ZodType>(rawInput: unknown, schema: T, expectedMethod: string): {
    cursor?: string;
    params: Record<string, unknown>;
};
/**
 * Entry with owner information for conflict resolution
 */
export interface OwnedEntry<T> {
    ownerName: string;
    entry: T;
}
/**
 * Resolved entry with final name after conflict resolution
 */
export interface ResolvedEntry<T> extends OwnedEntry<T> {
    finalName: string;
}
/**
 * Resolve name conflicts by prefixing with owner name.
 * Used for tools, resources, prompts, etc.
 *
 * @param entries - Array of entries with owner names
 * @param getBaseName - Function to extract base name from entry
 * @returns Resolved entries with final names
 */
export declare function resolveNameConflicts<T>(entries: OwnedEntry<T>[], getBaseName: (entry: T) => string): ResolvedEntry<T>[];
/**
 * Get a preview of items for logging (first N items).
 *
 * @param items - Array of items
 * @param getName - Function to extract display name from item
 * @param n - Number of items to preview (default: 5)
 * @returns Formatted preview string
 */
export declare function previewItems<T>(items: T[], getName: (item: T) => string, n?: number): string;
/**
 * Get the count of conflicts from entries.
 *
 * @param entries - Array of entries
 * @param getBaseName - Function to extract base name from entry
 * @returns Object with conflict count and conflict names
 */
export declare function detectConflicts<T>(entries: T[], getBaseName: (entry: T) => string): {
    count: number;
    names: string[];
};
//# sourceMappingURL=flow.utils.d.ts.map