import type { TreeSignalOutcome } from "../os/process-tree.js";
import type { Unsubscribe } from "./runtime.js";
import type { ControlInput, OutputStream, ProcessOutcome, SessionTransportKind, SubmitBehavior, TerminalDimensions } from "./types.js";
export interface TransportOutput {
    readonly stream: OutputStream;
    readonly bytes: Uint8Array;
    readonly observedAt: number;
}
export type DeliveryResult = {
    readonly status: "delivered";
    readonly deliveredBytes: number;
} | {
    readonly status: "not-delivered";
    readonly deliveredBytes: 0;
    readonly cause?: unknown;
} | {
    readonly status: "unknown";
    readonly deliveredBytes: number;
    readonly cause?: unknown;
};
export interface SessionTransport {
    readonly kind: SessionTransportKind;
    readonly pid: number;
    readonly processGroupId?: number | undefined;
    readonly identity: string | undefined;
    write(bytes: Uint8Array): Promise<DeliveryResult>;
    control(action: ControlInput): Promise<DeliveryResult>;
    closeInput(): Promise<DeliveryResult>;
    resize?(dimensions: TerminalDimensions): Promise<void>;
    pauseOutput(): void;
    resumeOutput(): void;
    requestTreeTermination(kind: "graceful" | "forceful"): Promise<TreeSignalOutcome>;
    onOutput(listener: (event: TransportOutput) => void): Unsubscribe;
    onExit(listener: (outcome: ProcessOutcome) => void): Unsubscribe;
    waitForOutputDrain?(): Promise<void>;
    dispose(): Promise<void>;
}
export interface LaunchIdentity {
    readonly pid: number;
    readonly processGroupId?: number | undefined;
    readonly identity: string | undefined;
}
export interface LaunchRequest {
    readonly command: string;
    readonly cwd: string;
    readonly env?: NodeJS.ProcessEnv | undefined;
    readonly onLaunchIdentity?: ((identity: LaunchIdentity) => void) | undefined;
}
export interface LaunchResult {
    readonly transport: SessionTransport;
}
export interface PtyCapability {
    readonly available: boolean;
    readonly platform: NodeJS.Platform;
    readonly reason?: string | undefined;
}
export interface SessionTransportFactory {
    capability(platform?: NodeJS.Platform): Promise<PtyCapability>;
    startPipe(request: LaunchRequest): Promise<LaunchResult>;
    startPty(request: LaunchRequest & {
        dimensions: TerminalDimensions;
    }): Promise<LaunchResult>;
}
export declare class LaunchFailure extends Error {
    readonly code: string;
    readonly spawnConfirmed: boolean;
    readonly transient: boolean;
    constructor(code: string, message: string, spawnConfirmed: boolean, transient: boolean);
}
export declare function enterSequence(kind: SessionTransportKind): Uint8Array;
export declare function encodeTextInput(text: string, submit: SubmitBehavior, kind: SessionTransportKind): Uint8Array;
export declare function ptyControlBytes(action: ControlInput, platform?: NodeJS.Platform): Uint8Array | undefined;
export type PipeControlAction = {
    readonly kind: "signal";
    readonly signal: NodeJS.Signals;
} | {
    readonly kind: "bytes";
    readonly bytes: Uint8Array;
} | {
    readonly kind: "close-input";
} | {
    readonly kind: "unsupported";
};
export declare function pipeControlAction(action: ControlInput, platform?: NodeJS.Platform): PipeControlAction;