import type { IAgent } from './agents';
/**
 * Compose the literal command line typed into a fresh terminal for `agent`.
 * When `prompt` is empty (or whitespace-only), this is just `agent.command`.
 * When non-empty, the prompt is shell-quoted and spliced in using the
 * agent's `promptArgs` recipe — see `IAgent.promptArgs` for the encoding.
 *
 * Returns `agent.command` unchanged when the agent declares no prompt
 * support (`promptArgs === undefined`), so a stray prompt typed into the
 * launcher does not silently mutate the launch line for that agent. The
 * launcher UI separately prevents the click in that case so the dropped
 * prompt is never surprising to the user.
 */
export declare function buildAgentInvocation(agent: IAgent, prompt: string): string;