import type { IsoTime, NodeIdDTO } from './common.js'; /** A still-live background bash job owned by one node. */ export interface BashJobStatusDTO { job_id: string; command: string; /** Human-readable label supplied with the bash call, or null when absent. */ purpose: string | null; started_at: IsoTime; elapsed_ms: number; /** Persisted supervisor process group, or null for legacy jobs. */ pgid: number | null; /** Whether the persisted process group currently exists. */ pgid_alive: boolean; } /** Result of stopping one background bash job. `signaled` is false when the * process group had already exited, but the job is still retired via its exit * sentinel. */ export interface BashJobStopResultDTO { node_id: NodeIdDTO; job_id: string; signaled: boolean; } /** Whether a job id is safe to interpolate as one API/filesystem segment. */ export declare function isSafeBashJobId(jobId: string): boolean;