import type { ShellActionExecution, ShellActionResult, ShellUpdateLine } from "./types.js";
/**
 * Retrieve the shell result attached to an error thrown by
 * {@link runShellAction}, so callers can persist the action receipt even when
 * the command failed.
 */
export declare function shellResultFromError(error: unknown): ShellActionResult | null;
export declare function renderShellCommand(command: string, args: string[]): string;
export declare function shellOutputTruncation(result: ShellActionResult): {
    stdout: boolean;
    stderr: boolean;
};
export declare function runShellAction(spec: ShellActionExecution, signal?: AbortSignal, onLine?: (line: ShellUpdateLine) => Promise<void>): Promise<ShellActionResult>;