/**
 * Run CLI Command
 *
 * Explicit `cli` command for directly invoking photon methods, plus the
 * implicit CLI mode (preprocessArgs) that rewrites bare photon names into
 * `cli` or `beam` subcommands before commander parses them.
 *
 * Also registers the unknown-command handler with "did you mean" suggestions.
 */
import type { Command } from 'commander';
export declare const RESERVED_COMMANDS: string[];
interface PreprocessResult {
    args: string[];
    githubRef: string | null;
    photonName: string | null;
}
/**
 * Rewrite process.argv before commander parses it so that bare photon names
 * are dispatched to `cli` (when method args follow) or `beam` (focus mode).
 *
 * Also handles GitHub shorthand refs (owner/repo or owner/repo/photon-name).
 */
export declare function preprocessArgs(): PreprocessResult;
/**
 * Register the `cli` command and the unknown-command handler with "did you mean"
 * suggestions.
 *
 * The `cli` command is the explicit escape hatch for running photon methods when
 * the photon name conflicts with a reserved command. It is also the implicit
 * dispatch target for bare photon invocations rewritten by preprocessArgs().
 */
export declare function registerRunCommand(program: Command): void;
export {};
//# sourceMappingURL=run.d.ts.map