/**
 * Argv parser shared by cli.ts and python passthrough.
 *
 * Convention (matches ab-agent's buildCliArgs):
 *   --foo-bar value     →  foo_bar: 'value'
 *   --foo-bar           →  foo_bar: true
 *   --foo-bar a --foo-bar b → foo_bar: ['a', 'b']
 *   -p value            →  short flags also supported as-is (kebab → snake)
 *
 * Booleans are detected when the next token starts with '--' or is absent.
 * Negative number values (-1.5) are NOT supported as flag values in this
 * parser — Python skills handle them via argparse downstream when needed.
 */
export type ParsedArgs = Record<string, string | boolean | string[]>;
export declare function parseArgv(argv: string[]): ParsedArgs;