/**
 * CLI argument parsing and help display
 */
import type { ThinkingLevel } from "@caupulican/pi-agent-core";
import type { ServiceTier } from "@caupulican/pi-ai";
import type { ExtensionFlag } from "../core/extensions/types.ts";
import { type TerminalSessionMode } from "../core/session-role.ts";
export type Mode = "text" | "json" | "rpc";
export interface Args {
    provider?: string;
    model?: string;
    apiKey?: string;
    systemPrompt?: string;
    appendSystemPrompt?: string[];
    worktreeLane?: string;
    parentPid?: number;
    parentSession?: string;
    taskRef?: string;
    sessionMode?: TerminalSessionMode;
    thinking?: ThinkingLevel;
    serviceTier?: ServiceTier;
    continue?: boolean;
    resume?: boolean;
    help?: boolean;
    version?: boolean;
    mode?: Mode;
    name?: string;
    noSession?: boolean;
    session?: string;
    sessionId?: string;
    fork?: string;
    sessionDir?: string;
    models?: string[];
    tools?: string[];
    excludeTools?: string[];
    noTools?: boolean;
    noBuiltinTools?: boolean;
    resourceProfiles?: string[];
    resourceProfileJson?: string[];
    orchestrationProfile?: string;
    extensions?: string[];
    noExtensions?: boolean;
    print?: boolean;
    /** Emit cumulative session usage (one JSON line, `__PI_USAGE__` prefix) to stderr at exit (text print mode). */
    printUsage?: boolean;
    export?: string;
    noSkills?: boolean;
    skills?: string[];
    promptTemplates?: string[];
    noPromptTemplates?: boolean;
    themes?: string[];
    noThemes?: boolean;
    noContextFiles?: boolean;
    listModels?: string | true;
    offline?: boolean;
    verbose?: boolean;
    projectTrustOverride?: boolean;
    messages: string[];
    fileArgs: string[];
    /** Unknown flags (potentially extension flags) - map of flag name to value */
    unknownFlags: Map<string, boolean | string>;
    diagnostics: Array<{
        type: "warning" | "error";
        message: string;
    }>;
}
export declare function isValidThinkingLevel(level: string): level is ThinkingLevel;
export declare function parseArgs(args: string[]): Args;
export declare function printHelp(extensionFlags?: ExtensionFlag[]): void;
//# sourceMappingURL=args.d.ts.map