Convert a .eml email file to Markdown with YAML front matter.

Returns the full Markdown content (front matter + body). When output_path is provided, also writes the file to disk.

Presets bundle common flag combinations:

• default: strips signatures, tracking pixels, signature images

• clean: default + strips disclaimers and quoted headers

• verbose: includes all headers and raw HTML

• raw: no stripping, preserves everything

Individual flags override the preset when provided.

Convert a .eml file to a self-contained bundle with markdown and attachments.

Creates a directory containing the converted markdown, extracted attachments, and optionally the original .eml source.

source_handling controls the original .eml:

• copy (default): copy into bundle, leave original untouched

• move: move original into bundle

• delete: remove original after successful conversion

Returns JSON with bundle_path, markdown_path, attachment_paths, and optional diagnostics.

Batch convert all .eml files in a directory to Markdown.

Recursively finds all .eml files and converts them. Returns a JSON summary with total, successes, failures, output_paths, and errors.

Use convert_eml to retrieve individual converted file content.

Inspect email quality and structure without writing permanent files.

Use this to assess conversion quality before committing, or to troubleshoot problematic .eml files.

Returns JSON with: state (normal/degraded/review_recommended), selected_body, segmentation_path, client_hint, confidence, warnings, and stripped_images.