import { type RunSkillsDeps, type RunSkillsOptions } from './skills';
/** A spawn shim so the npm call can be faked in unit tests. */
export type SpawnInstall = (command: string, args: string[]) => Promise<number>;
/**
 * Run `npm install -g a14y` so the CLI lands permanently on PATH. Returns the
 * exit code. Set `A14Y_INSTALL_SKIP_GLOBAL=1` to skip the spawn (used by the
 * integration tests so they don't touch the real global prefix).
 */
export declare function globalInstall(spawnImpl?: SpawnInstall): Promise<number>;
export interface RunInstallDeps extends RunSkillsDeps {
    /** Override the `npm install -g a14y` step (defaults to {@link globalInstall}). */
    installGlobally?: () => Promise<number>;
    /** Override the skill-install step (defaults to {@link runSkillsCommand}). */
    runSkill?: (opts: RunSkillsOptions, deps: RunSkillsDeps) => Promise<number>;
}
/**
 * `a14y install`: install the CLI globally, then install the agent skill. The
 * two steps are independent — if the global install fails we warn and still set
 * up the skill, but the command exits non-zero so the failure is visible.
 */
export declare function runInstallCommand(opts: RunSkillsOptions, deps: RunInstallDeps): Promise<number>;