/** Canonical lifecycle values emitted by the MINT Python SDK job contract. */
export type JobStatus =
  | 'awaiting_input'
  | 'queued'
  | 'running'
  | 'completed'
  | 'failed'
  | 'cancelled'

export interface JobProgress {
  current_file: number
  total_files: number
  current_filename: string | null
  percent: number
  message: string
  stage: string
}

/** Normalized job state used by SDK job UI. */
export interface JobState {
  id: string
  job_id: string
  kind: string
  name: string
  definition_id: string | null
  status: JobStatus
  progress: JobProgress
  queue_position: number
  warnings: string[]
  error: string | null
  output_path: string | null
  save_path: string | null
  session_id: string | null
  folders: string[]
  folder_path: string | null
  user_id: string | null
  owner_user_id: string | null
  experiment_id: string | null
  extraction_result_id: string | null
  metadata: Record<string, unknown>
  created_at: string
  started_at: string | null
  completed_at: string | null
  can_cancel: boolean
  can_delete: boolean
  result_status: 'none' | 'available' | 'expired'
  result_expires_at: string | null
}

/** Backward-compatible transport shape accepted from pre-capability backends. */
export type JobStateInput = Omit<
  JobState,
  'can_cancel' | 'can_delete' | 'definition_id' | 'result_status' | 'result_expires_at'
> & {
  can_cancel?: boolean | null
  can_delete?: boolean | null
  definition_id?: string | null
  result_status?: 'none' | 'available' | 'expired'
  result_expires_at?: string | null
}

export interface JobListPayload {
  jobs: JobStateInput[]
}

export interface JobSnapshotPayload {
  jobs: JobStateInput[]
}

export type JobStreamData = JobStateInput | JobSnapshotPayload