/** Success/failure shape returned by an interceptor-backed executor. */
export type ExecutionResult<T> = {
    ok: true;
    data: T;
} | {
    ok: false;
    status: number;
    message: string;
};
/** Function signature shared by AppKit plugin executors. */
export type Executor<Settings> = <T>(fn: (signal?: AbortSignal) => Promise<T>, settings: Settings) => Promise<ExecutionResult<T>>;
/** Failure details supplied when an intercepted operation cannot complete. */
export interface ExecutionFailure {
    operation: string;
    status: number;
    message: string;
}
/** Options for running and unwrapping one intercepted operation. */
export interface RunOptions<T, Settings> {
    operation: string;
    settings: Settings;
    execute: Executor<Settings>;
    fn: (signal?: AbortSignal) => Promise<T>;
    signal?: AbortSignal;
    canceled: () => Error;
    failed: (failure: ExecutionFailure) => Error;
}
/**
 * Build the executor used before a plugin installs its interceptor chain.
 * Errors are mapped onto the same result shape as AppKit's `Plugin.execute()`.
 */
export declare function directExecutor<Settings>(): Executor<Settings>;
/** Run an operation through an executor, merge cancellation, and unwrap its result. */
export declare function run<T, Settings>(options: RunOptions<T, Settings>): Promise<T>;