import { type RunnerScope, type ResolvedConfig, type StateManager } from "../../poe-code-config/dist/index.js";
import { selectExecutionEnv, type OpenSpec } from "./execution-env.js";
export type RuntimeOverrideOptions = {
    runtime?: "host" | "docker";
    runtimeImage?: string;
    detach?: boolean;
    mountPoeCode?: boolean;
    runnerSync?: RunnerScope["sync"];
};
export declare function resolvePoeCommandExecution(input: {
    cwd: string;
    runtimeConfigCwd?: string;
    env: Record<string, string>;
    argv: string[];
    displayArgv?: string[];
    tool: string;
    runtime?: RuntimeOverrideOptions;
    context?: {
        homeDir?: string;
        state?: StateManager;
    };
    openSpec?: Partial<Pick<OpenSpec, "execution" | "shellSpec">>;
}): {
    factory: ReturnType<typeof selectExecutionEnv>;
    openSpec: OpenSpec;
    detach: boolean;
    state: StateManager;
};
/** Raised when a requested runner capability is not offered by the resolved execution env. */
export declare class UnsupportedRuntimeCapabilityError extends Error {
    constructor(message: string);
}
export interface LoadedRuntimeConfig extends ResolvedConfig {
    /** Raw merged runtime scope preserved for re-parsing when overrides change the type. */
    rawScope: Record<string, unknown>;
}
export declare function applyRuntimeOverrides(config: ResolvedConfig | LoadedRuntimeConfig, overrides: RuntimeOverrideOptions | undefined, cwd?: string): ResolvedConfig;