Picture in. PDF/A out. Capsule hashed. GPU-free. Command::Convert · SHA-256 ×3 · i32 1/7200" · PNG/JPEG → PDF/A XObject · not OCR. MinerU parses a scan. DocAgent embeds a PNG.

vs the field · Quickstart · What ships · API · Docs

_{examples/letter.md → PDF/A + HTML + capsule. Teal harbor mark under the H2. JSON b468b37f…; trio/capsule panel still b867db0a… (shots lag — not a fake hash). WeasyPrint tightness not claimed closed.}

Locked against the ten most-starred document repositories an agent actually meets (star counts 2026-09-06). Agent-runtime matrix, not an OCR bake-off. No OmniDocBench numbers.

North star: drop examples/letter.md (or DOCX/ODT) that contains a PNG or JPEG, and get PDF/A + HTML + Markdown + DOCX + ODT whose bytes match the next run, with three hashes in the capsule. The picture is a PDF/A XObject. Not OCR.

Images: yes PNG + JPEG on Markdown / HTML / PDF/A / DOCX / ODT. — on Hangul. The demo letter is ![Harbor mark](docs/assets/mark.png). First-screen convert shot above shows the teal mark under the H2. Demo-image gap closed. Print-CSS tightness vs WeasyPrint is not claimed closed.

git clone https://github.com/kevin9327/docagent
cd docagent
cargo test --workspace
cargo run -p docagent-cli -- convert examples/letter.md \
  --pdf out.pdf --html out.html --odt out.odt --docx out.docx --capsule cap.json
cargo run -p docagent-cli -- prove examples/letter.md

examples/letter.md contains ![Harbor mark](docs/assets/mark.png). Convert paints that teal mark under the H2 as a PDF/A XObject. prove converts twice (PDF/A + HTML) and exits 0 only when the bytes and the three SHA-256 hashes match. The prove JSON (letter-prove.json) is a separate artifact from the convert capsule in the table above — those plan/output hashes stay distinct (928b4745… / 2607bb6f…). Do not copy them onto letter-capsule.json.

Binaries: docagent (CLI) · docagentd (daemon) · MCP + WIT adapters over the same Engine.

use docagent_api::{Command, Engine, ExportTarget};

let mut engine = Engine::new();
let out = engine.execute(Command::Convert {
    input: std::fs::read("examples/letter.md")?,
    input_kind: None,
    targets: vec![ExportTarget::PdfA, ExportTarget::Html, ExportTarget::Markdown],
})?;
// out.capsule.{input_hash, plan_hash, output_hash}

MinerU, Docling, Marker, and Unstructured turn documents into tokens for models. Pandoc, python-docx, WeasyPrint, ONLYOFFICE, and LibreOffice turn documents into other documents. DocAgent is the runtime in the middle that an agent can call, replay, and prove.

Honest codec coverage — not a wishlist. Full table: docs/src/capabilities.md.

Images are the first-class row. PNG and JPEG round-trip on Markdown, HTML, PDF/A, DOCX, and ODT. They stay — on Hangul. That dash is real.

HTML read recovers data-URI <img>, lists, <th>/<thead>, <blockquote>, <pre>, <a href>, and <mark> into the same IR. http(s): src is skipped. This is not a full HTML5 engine.

No spreadsheet. No slides. No cursor. No undo stack. No OCR. Flow documents only.

Files from examples/letter.md: PDF/A · HTML · DOCX · ODT · Markdown · capsule JSON.

![Harbor mark](docs/assets/mark.png)

_{Capsule from examples/letter.md: input / plan / output SHA-256. JSON b468b37f…; shot still shows b867db0a… (shots lag — not a fake hash). Two converts, same fonts, same bytes. GPU-free. Deterministic. Not OCR.}

The test is letter_md_is_byte_identical_across_two_runs. Hashes above are the hashes in letter-capsule.json.

Command  →  Convert | Import | Export | LayoutDocument
Query    →  EngineVersion | LastCapsule | LastDocument | CapsuleByInputHash
Event    →  CommandCompleted { capsule_id } | Warning

Every Command writes a capsule. CLI, daemon, MCP, and WIT are thin adapters over the same Engine. See AGENTS.md and docs/src/intro.md.

flowchart LR
  A[DOCX / ODT / MD / HTML + PNG/JPEG] --> B[docagent-model IR]
  B --> C[docagent-layout<br/>i32 @ 1/7200 in]
  C --> D[PDF/A XObject]
  C --> E[HTML]
  C --> F[DOCX / ODT / MD]
  B --> G[capsule.json<br/>input · plan · output]

Codecs (docx, odt, md, html, hwp5, hwpx, hwp3, hml) do not import each other and do not import layout. Layout, paint, raster, and PDF do not know the source format.

cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings
cargo run -p docagent-lint
cargo run -p docagent-conformance -- --require-win

• Intro
• What ships
• Format hops
• ADRs — crate boundaries, integer layout, single engine, capsules

MIT. See LICENSE.