import { type PluginConfig } from '../config';
/**
 * Normalizes an agent name by trimming whitespace and removing the optional @ prefix.
 *
 * @param agentName - The agent name to normalize (e.g., "@oracle" or "oracle")
 * @returns The normalized agent name without @ prefix and trimmed of whitespace
 *
 * @example
 * normalizeAgentName("@oracle") // returns "oracle"
 * normalizeAgentName("  explore  ") // returns "explore"
 */
export declare function normalizeAgentName(agentName: string): string;
/**
 * Resolves the variant configuration for a specific agent.
 *
 * Looks up the agent's variant in the plugin configuration. Returns undefined if:
 * - No config is provided
 * - The agent has no variant configured
 * - The variant is not a string
 * - The variant is empty or whitespace-only
 *
 * @param config - The plugin configuration object
 * @param agentName - The name of the agent (with or without @ prefix)
 * @returns The trimmed variant string, or undefined if no valid variant is found
 *
 * @example
 * resolveAgentVariant(config, "@oracle") // returns "high" if configured
 */
export declare function resolveAgentVariant(config: PluginConfig | undefined, agentName: string): string | undefined;
/**
 * Resolve a runtime-provided agent name to an internal agent name.
 *
 * Supports:
 * - internal names (e.g. "oracle")
 * - @-prefixed names (e.g. "@oracle")
 * - displayName aliases (e.g. "advisor" -> "oracle")
 */
export declare function resolveRuntimeAgentName(config: PluginConfig | undefined, agentName: string): string;
export type DisplayNameMentionRewriter = (text: string) => string;
export declare function createDisplayNameMentionRewriter(config: PluginConfig | undefined): DisplayNameMentionRewriter;
/**
 * Rewrites user-facing display-name mentions (e.g. @advisor) into internal
 * agent mentions (e.g. @oracle) for runtime routing.
 */
export declare function rewriteDisplayNameMentions(config: PluginConfig | undefined, text: string): string;
/**
 * Applies a variant to a request body if the body doesn't already have one.
 *
 * This function will NOT override an existing variant in the body. If no variant
 * is provided or the body already has a variant, the original body is returned.
 *
 * @template T - The type of the body object, must have an optional variant property
 * @param variant - The variant string to apply (or undefined)
 * @param body - The request body object
 * @returns The body with the variant applied (new object) or the original body unchanged
 *
 * @example
 * applyAgentVariant("high", { agent: "oracle" }) // returns { agent: "oracle", variant: "high" }
 * applyAgentVariant("high", { agent: "oracle", variant: "low" }) // returns original body with variant: "low"
 */
export declare function applyAgentVariant<T extends {
    variant?: string;
}>(variant: string | undefined, body: T): T;