/**
 * Orchestrator-context loader.
 *
 * Reads the file referenced by `--context-file <path>` (or the
 * `AMPLITUDE_WIZARD_CONTEXT` env var) and returns its contents as a
 * UTF-8 string the wizard prepends to the inner-agent's system prompt.
 *
 * Surface area is deliberately tiny — the file's contents flow into
 * Claude system-prompt territory, so the loader's only jobs are:
 *
 *   1. Read the file (sync, blocking, before the agent starts).
 *   2. Cap the size at 64 KB so a runaway dump can't bloat every turn.
 *   3. Strip a UTF-8 BOM if present (editors silently insert one).
 *   4. Return a clean error envelope on failure so the CLI can decide
 *      whether to abort (TUI / classic) or emit `auth_required`-style
 *      structured rejection (agent / CI).
 *
 * Env-var fallback: if the user passes BOTH `--context-file` and
 * `AMPLITUDE_WIZARD_CONTEXT`, the CLI flag wins (consistent with the
 * rest of the wizard's flag-over-env precedence).
 */
export declare const MAX_ORCHESTRATOR_CONTEXT_BYTES: number;
export type LoadOrchestratorContextResult = {
    ok: true;
    content: string;
    sourcePath: string;
    bytes: number;
} | {
    ok: false;
    reason: 'not_found' | 'too_large' | 'read_failed' | 'empty' | 'not_a_file';
    sourcePath: string;
    message: string;
};
/**
 * Resolve the orchestrator-context source path: explicit `--context-file`
 * argument wins over `AMPLITUDE_WIZARD_CONTEXT`. Returns null when neither
 * is set so the caller can skip the read entirely.
 */
export declare function resolveOrchestratorContextPath(flagValue: string | undefined, env?: NodeJS.ProcessEnv): string | null;
export declare function loadOrchestratorContext(rawPath: string, cwd?: string): LoadOrchestratorContextResult;
