The Complete Production SOP: How to Deploy and Run PDF Master & Poppler QA in Autonomous AI Agents

---
name: "pdf-master"
description: "Read, create, inspect, render, and verify PDF files where visual layout matters."
triggers:
  - "read pdf"
  - "generate invoice pdf"
  - "extract pdf tables"
  - "verify pdf layout"
dependencies:
  python: ["pypdf", "pdfplumber", "reportlab", "pdf2image"]
  tools: ["pdftoppm"]
---

# PDF Master Procedural Rules
- When generating: Always build with ReportLab Platypus SimpleDocTemplate.
- When extracting: Read bounding boxes via pdfplumber.extract_tables().
- Quality Gate: Always render PDF to PNG via pdftoppm at 150 DPI and inspect layout.

import shutil
import sys

required_bins = ["pdftoppm", "pdfinfo"]
missing = [b for b in required_bins if shutil.which(b) is None]

if missing:
    sys.stderr.write(f"Error: Missing system binaries: {missing}\n")
    sys.exit(1)
print("PDF Master runtime dependencies successfully validated.")

from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Table, TableStyle
from reportlab.lib.styles import getSampleStyleSheet
from reportlab.lib import colors

def build_invoice(filename="invoice_8841.pdf"):
    doc = SimpleDocTemplate(filename, pagesize=letter, rightMargin=36, leftMargin=36, topMargin=36, bottomMargin=36)
    styles = getSampleStyleSheet()
    story = []
    story.append(Paragraph("INVOICE #8841", styles["Heading1"]))
    story.append(Spacer(1, 12))
    data = [["Item", "Qty", "Rate", "Total"], ["Skill Audit", "1", "$500", "$500"]]
    table = Table(data, colWidths=[200, 80, 80, 100])
    table.setStyle(TableStyle([
        ('BACKGROUND', (0,0), (-1,0), colors.HexColor("#1e293b")),
        ('TEXTCOLOR', (0,0), (-1,0), colors.whitesmoke),
        ('GRID', (0,0), (-1,-1), 0.5, colors.grey),
    ]))
    story.append(table)
    doc.build(story)

if __name__ == "__main__":
    build_invoice()

import pdfplumber
import subprocess
from pathlib import Path

def verify_pdf(pdf_path: str):
    p = Path(pdf_path)
    assert p.exists(), f"{pdf_path} not found"
    # Rasterize
    subprocess.run(["pdftoppm", "-png", "-r", "150", str(p), "qa_render"], check=True)
    # Coordinate Check
    with pdfplumber.open(p) as pdf:
        for idx, page in enumerate(pdf.pages):
            tables = page.extract_tables()
            assert len(tables) > 0, f"Page {idx+1} failed table structure extraction"
    print("QA Verification Gate: PASS")

if __name__ == "__main__":
    verify_pdf("invoice_8841.pdf")