import { type AxiRenderable } from "./output.js";
/**
 * Command names reserved by the SDK as built-ins. A tool may shadow one by
 * registering its own handler in `options.commands`.
 */
export declare const RESERVED_COMMANDS: readonly ["update"];
type MaybePromise<T> = T | Promise<T>;
export type AxiCliCommand<TContext> = (args: string[], context: TContext | undefined) => MaybePromise<AxiRenderable>;
export interface AxiResolveContextInput {
    command: string | undefined;
    args: string[];
}
export interface AxiCliOptions<TContext = undefined> {
    description: string;
    version?: string;
    /**
     * npm package name override for the built-in `update` command. Defaults to the
     * name resolved from the nearest `package.json`, so most tools never set it.
     */
    packageName?: string;
    argv?: string[];
    topLevelHelp: string;
    commands: Record<string, AxiCliCommand<TContext>>;
    home: AxiCliCommand<TContext>;
    getCommandHelp?: (command: string) => string | null | undefined;
    initialize?: () => MaybePromise<void>;
    resolveContext?: (input: AxiResolveContextInput) => MaybePromise<TContext>;
    stdout?: {
        write: (chunk: string) => unknown;
    };
    renderUnknownCommand?: (command: string) => string;
    formatError?: (error: unknown) => {
        output: string;
        exitCode: number;
    };
}
export declare function runAxiCli<TContext = undefined>(options: AxiCliOptions<TContext>): Promise<void>;
export {};