import type { CliArgvPredicateExprV1, CliExecutionModeV1 } from '@nexusclaw/shared';
export declare const CLI_MODE_UNMATCHED = "CLI_MODE_UNMATCHED";
export declare const CLI_MODE_AMBIGUOUS = "CLI_MODE_AMBIGUOUS";
export declare const CLI_MODE_USAGE_EXIT: 64;
export type CliParsedOptionValue = string | number | boolean;
export type CliParsedOptions = Readonly<Record<string, CliParsedOptionValue>>;
export declare function validateArgvPredicate(expression: CliArgvPredicateExprV1, knownOptions: ReadonlySet<string>, depth?: number): void;
export declare function evaluateArgvPredicate(expression: CliArgvPredicateExprV1, options: CliParsedOptions): boolean;
export type CliModeResolution = {
    ok: true;
    mode: CliExecutionModeV1;
} | {
    ok: false;
    code: typeof CLI_MODE_UNMATCHED | typeof CLI_MODE_AMBIGUOUS;
    exitCode: typeof CLI_MODE_USAGE_EXIT;
};
export declare function resolveExecutionMode(modes: ReadonlyArray<CliExecutionModeV1>, options: CliParsedOptions): CliModeResolution;