import type { ShellActionExecution, ShellActionResult } 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 runShellAction(spec: ShellActionExecution, signal?: AbortSignal): Promise<ShellActionResult>;