docx

name	docx
description	Create polished, editable Microsoft Word documents such as reports, letters, proposals, and handbooks.

DOCX

Create the requested Word document in /workspace with the preinstalled python-docx package. Never install or download dependencies.

Authoring rules

• Use one page size and orientation for the document unless the user asks for a different layout. Prefer portrait; narrow wide content instead of silently switching sections to landscape.
• Choose the page size the user requests, or the locale-appropriate default when they do not specify one.
• Set margins of at least 18 mm and use built-in heading levels.
• Set table and cell widths deliberately and use a visible table grid.
• Use Word numbering/list styles; never insert literal • characters.
• Put page breaks in their own paragraphs. Use separate paragraphs instead of newline characters for separate blocks.
• Do not add a table of contents unless the user asks. If requested, use built-in heading levels and state that page numbers populate when Word opens and updates the field.
• For right-aligned text on the same line, use a right tab stop.
• Generate the document as one whole document. Do not assemble or save one DOCX per intended page; Word controls pagination through reflow.

Revisions

Start an in-place revision with load_artifact_for_revision. Use python-docx to open primary_path, make common edits directly to the existing document, and write the result to expected_output_path. Common edits include paragraph text and styles, headings, ordinary tables, lists, headers/footers, section settings, and embedded images that python-docx can safely preserve.

If the requested edit touches a structure python-docx cannot safely interpret or preserve—such as macros, SmartArt, complex fields, tracked changes, content controls, or unsupported drawing/layout XML—stop and report the blocker. Do not silently rebuild from markdown_path and do not fall back to a Markdown-only deliverable. Rebuild the DOCX from Markdown/context only when the user explicitly requested or accepted that lossy rebuild.

Do not use vision to reconstruct the document; verify_artifact may use vision after the revision is written. Save the verified revision with the returned artifact_id and expected_generation. A changed title, filename, or design is still the same artifact unless the user explicitly asks for a separate copy.

Verify and save

Call verify_artifact(path=output_path). Warnings are advisory. If it reports blocking findings, fix all blockers together, regenerate once at the same output path, and reverify. If a blocker remains, stop and explain it instead of entering another automatic rewrite loop.

Then call save_artifact(path=output_path, title="...", markdown_representation="..."). Working files may use any paths; no source file, preview file, or matching filename stem is part of the publication contract. The Markdown representation must faithfully contain the document's substantive text for accessibility and search.