import { type LoopEventHandler, type LoopEventName } from "./loop-events.js";
import { type LoopRunConfig, type LoopRunState, type LoopStatus } from "./loop-run.js";
import { type OpencodeRuntime, type OpencodeEventSubscription } from "./opencode-client.js";
import { type EngineTemplates } from "./templates.js";
export type LoopToastVariant = "success" | "warning" | "error" | "info";
export type LoopToastNotifier = (input: {
    title: string;
    message: string;
    variant: LoopToastVariant;
}) => Promise<void>;
export type LoopEngineOptions = {
    runtime: OpencodeRuntime;
    templates?: EngineTemplates;
    /** Override OpenCode event subscription (used by tests). */
    subscribeEvents?: (onEvent: (event: unknown) => void | Promise<void>) => Promise<OpencodeEventSubscription>;
    onToast?: LoopToastNotifier;
};
/** Controls a single Ralph loop run for one supervisor session. */
export type LoopEngine = {
    readonly state: LoopRunState;
    on: (event: LoopEventName, handler: LoopEventHandler) => () => void;
    start: (config?: Partial<LoopRunConfig>) => Promise<void>;
    pause: (reason?: string) => Promise<void>;
    resume: () => Promise<void>;
    stop: (reason?: string) => Promise<void>;
    status: () => Promise<LoopStatus>;
    peekWorker: (maxLines?: number) => Promise<string>;
    /** Process one OpenCode event (serialized through an internal queue). */
    handleEvent: (event: unknown) => Promise<void>;
    dispose: () => void;
};
/** Create a loop engine bound to a supervisor session and worktree. */
export declare function createLoopEngine(config: LoopRunConfig, options: LoopEngineOptions): LoopEngine;
export declare function createDefaultLoopEngine(config: LoopRunConfig): LoopEngine;
//# sourceMappingURL=loop-engine.d.ts.map