/**
 * 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";
/**
 * Log line which separates the raw script input from the raw script output of one execution section.
 *
 * Readers of a runtime log split on this marker to look only at what the harness really produced,
 * without the generated script and the prompt it embeds.
 */
export declare const SCRIPT_EXECUTION_LOG_RAW_OUTPUT_MARKER = "--- raw output ---";
/**
 * Environment variable that identifies the Node process responsible for a temporary harness shell.
 */
export declare const PTBK_CODER_PARENT_PROCESS_ID_ENV_NAME = "PTBK_CODER_PARENT_PROCESS_ID";
/** Private stdin command asks the owning wrapper to stop its actual harness job before exiting. */
export declare const PTBK_CODER_CANCEL_COMMAND = "PTBK_CANCEL_OWNED_HARNESS";
/**
 * Shapes one bash invocation that optionally mirrors live script output into a temporary log file.
 */
export declare function buildLoggedBashExecution(scriptPath: string, logPath?: string, isLoginShell?: boolean): {
    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>;