import type { JobRefusal, JobRpcResult, JobStatus } from "@aicommander/protocol";
/** Version-one record stored in each job directory. */
export interface JobMeta {
    v: 1;
    jobId: string;
    name: string;
    command: string;
    cwd: string;
    status: JobStatus;
    exitCode: number | null;
    startedAt: number;
    endedAt: number | null;
    endedAtApproximate?: boolean;
    /** Kept open-ended so records from newer agents remain readable. */
    unknownReason?: string;
    gpuIndex: number | null;
    pid: number | null;
    procIdentity: string | null;
    retiring?: boolean;
    /** Durable cancellation marker; it survives an agent restart. */
    cancelRequestedAt?: number;
    scope?: string;
    /** Served log boundary; the process may continue writing beyond it. */
    truncatedAt: number | null;
}
export interface JobStartRequest {
    /** Internal, best-effort masked identity lookup; never persisted in job metadata. */
    resolveOperator?: () => Promise<string>;
    command: string;
    cwd?: string;
    env?: Record<string, string>;
    name?: string;
    gpuIndex?: number;
    /** Aborted when the connection can no longer receive the new job id. */
    signal?: AbortSignal;
}
export interface JobListRequest {
    status?: JobStatus;
    limit?: number;
    includeCommand?: boolean;
}
export interface JobStatusRequest {
    jobId: string;
    includeCommand?: boolean;
}
export interface JobLogsRequest {
    jobId: string;
    tailLines?: number;
    offsetBytes?: number;
    maxBytes?: number;
}
export interface JobCancelRequest {
    jobId: string;
}
/** Unexpected local-machine failure, distinct from a request refusal. */
export declare class JobError extends Error {
    readonly code: string | undefined;
    readonly detail: string | undefined;
    constructor(message: string, code?: string, detail?: string);
}
export type StartAbortReason = "cancelled" | "abandoned";
/** Mutable state for the interruptible record-to-process start window. */
export interface StartWindow {
    abort: StartAbortReason | null;
    erasing: boolean;
}
export declare class StartAborted extends Error {
    readonly reason: StartAbortReason;
    constructor(reason: StartAbortReason);
}
export declare function notFound(): JobRpcResult;
export declare function invalidRequest(message: string): JobRefusal;
export declare function errText(err: unknown): string;