import type { ShellResult } from "@boardwalk-labs/workflow/runtime";
/** Default cap on captured stdout/stderr bytes (matches the SDK's documented 16 MiB). */
export declare const SHELL_DEFAULT_MAX_BUFFER: number;
export interface ShellExecOptions {
    cwd?: string | undefined;
    env?: Record<string, string> | undefined;
    timeoutMs?: number | undefined;
    maxBuffer?: number | undefined;
}
export interface ShellExecDeps {
    /** The run's workspace root — the default cwd, and the base a relative `cwd` resolves against. */
    workspaceRoot: string;
    /** The run's cooperative-cancellation signal: an abort kills the command and REJECTS. */
    signal?: AbortSignal | undefined;
}
/** Run one shell command to completion (see the module header for the resolve/reject contract). */
export declare function runShell(cmd: string, opts: ShellExecOptions | undefined, deps: ShellExecDeps): Promise<ShellResult>;