/**
 * Environment variable read by the shell wrapper to tee live output into the temporary runtime log file.
 */
export declare const PTBK_CODER_LOG_FILE_ENV_NAME = "PTBK_CODER_LOG_FILE";
/**
 * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
 */
export declare function buildLoggedBashExecution(scriptPath: string, logPath?: string): {
    args: string[];
    env?: Record<string, string>;
};
/**
 * Appends one execution-start section with the raw script input before the shell begins producing output.
 */
export declare function appendScriptExecutionLogStart({ scriptPath, scriptContent, logPath, }: {
    scriptPath: string;
    scriptContent: string;
    logPath?: string;
}): Promise<void>;
/**
 * Appends one execution-finish section after the shell settles.
 */
export declare function appendScriptExecutionLogFinish({ scriptPath, logPath, status, details, }: {
    scriptPath: string;
    logPath?: string;
    status: string;
    details?: unknown;
}): Promise<void>;