import { ServerProcessRegistry, type ProcessIdentity } from "./processes.js";
import type { RunnerOutcome } from "./state.js";
export type SupervisedRunnerResult = {
    outcome: RunnerOutcome;
    exitCode: number | null;
    signal: NodeJS.Signals | null;
    diagnostic?: string;
};
type ChildRunnerSupervisorOptions<Message, Response> = {
    label: string;
    registry: ServerProcessRegistry;
    onMessage: (message: Message) => Promise<Response>;
    parseMessage: (frame: Buffer) => Message;
    encodeResponse: (response: Response) => Buffer;
    isReady: (message: Message) => boolean;
    isTerminal: (message: Message) => boolean;
    startupTimeoutMs?: number;
    maxMessageBytes?: number;
    oversizedMessage?: string;
    onSpawn?: (identity: ProcessIdentity) => void;
    onDiagnostic?: (message: string) => void;
};
type ChildRunnerStartOptions = {
    args: string[];
    cwd: string;
    env: NodeJS.ProcessEnv;
};
/** Shared supervision, framing, diagnostics, and process-group shutdown for server runners. */
export declare class ChildRunnerSupervisor<Message, Response> {
    private readonly options;
    private child;
    private identity;
    private readonly decoder;
    private diagnostic;
    private terminalMessage;
    private stopping;
    private processing;
    private readyResolve;
    private readyReject;
    private exitResolve;
    private readonly readyPromise;
    private readonly exitPromise;
    constructor(options: ChildRunnerSupervisorOptions<Message, Response>);
    start(options: ChildRunnerStartOptions): Promise<void>;
    wait(): Promise<SupervisedRunnerResult>;
    stop(outcome?: RunnerOutcome): Promise<void>;
    private onStdout;
    private onStderr;
    private appendDiagnostic;
    private onExit;
}
export {};