Insert an image file into the document and write a NEW file (delegate).

Append a text paragraph and write a NEW file (python-hwpx delegate; reserialized, re-validate after).

Append a rows x cols table and write a NEW file (python-hwpx delegate).

Detect fillable fields in FILE MODE: labels, inline blanks, placeholders, checkboxes, form fields.

Estimate overflow/fit risk for candidate values against detected field capacity.

Write the previewed addressed edits to a NEW file-mode output copy.

The reviewed addressed plan came from structural addresses, not {} named fields, so repeated "▶", repeated "○○○", ordinary table cells, and paragraphs stay explicitly scoped. This applies the session_id returned by preview_addressed_edits(...) together with the required out_path after you already gathered all values first; do not turn whole-template completion into one tool call per cell or mix live field writes and then fall back to file mode. It does not mutate the already-open same Hangul window for the same document. Keep repeated text explicit with structural scope instead of an unscoped global replacement. After apply succeeds, open the verified output file afterward if live review is needed.

Atomically publish a reviewed three-variant assessment bundle to a safe root.

Write a previewed edit session to a NEW file with journal/snapshot for restore.

Fill a small set of label:value CELLS in the OPEN Hangul window live.

Handles empty label:value cells AND inline blanks (colon "은행명:", marker "∘ 프로그램명", checkboxes). Value insertion only — no formatting/styling. Not for whole-template completion: use compact inspect plus complete_addressed_template(path, edits, out_path) or the complete_and_load route — new file created, original untouched, opened as a new tab (plain open_in_hwp may reuse the active tab). Attaches to the automation-visible instance on call and verifies the requested exact path is active; if not, it opens it there when open_if_needed=true. Cold start can take tens of seconds. Preview first with preview_small_live_label_cells.

Apply a previously previewed pathless current-document edit by token only.

The token is authoritative: no fresh values or target hints, and the selected broker and exact target are revalidated before mutating the live document. complete_and_load tokens instead write the verified completion to the NEW file from the preview and open it as a new tab — the original stays untouched and the created path is returned even if the open fails. This path does not expose a timeout_seconds worker-isolation contract.

One-shot VALUE fill of named form fields (누름틀) in the OPEN Hangul window.

Value insertion only — formatting/styling edits are not supported live; use the file-mode delegate tools instead. Legacy pathless mode writes to the active automation document; with path=... it performs broker-targeted exact-path live apply and refuses to guess across multiple automation brokers. No timeout_seconds worker-isolation contract yet.

Apply multiple find->replace pairs to a NEW file in one pass (text substitution only).

Complete a whole template in ONE addressed file-mode call and write a new copy.

Gather or generate all values first, then send one edits array here — not one call per cell. edits do NOT require {} named fields; use structural addresses for repeated "▶", repeated "○○○", ordinary table cells, and paragraphs, and never treat repeated text as a document-wide replace without explicit scope. Start in file mode for whole-template completion instead of mixing live field writes and falling back to file mode later. This addressed file-mode path writes out_path only and does not mutate the already-open same Hangul window; open the verified output afterward.

Create an HWPX from ordered content blocks (delegate).

Create an HWPX from a DocumentSpec v1 payload (validated template union; delegate).

Create an HWPX from Markdown content (delegate).

Create a new HWPX containing one table from headers/rows (delegate).

Create a Korean official-document (gongmun) skeleton HWPX from fields (delegate).

Report per-capability availability, tool buckets, and runtime identity for this PC.

Detect whether a path is HWPX (zip+mimetype), binary HWP, or unknown.

Apply bold/italic/underline/color/size to matched text and write a NEW file (delegate).

Headless .hwp text extraction gate; returns available:false until a verified non-COM reader lands.

Extract plain document text from an HWPX file (returns a string).

Fill detected named/label fields and write a NEW byte-preserving HWPX copy (file mode).

Locate the input cell next to or under a label cell in tables.

Count plain-text matches per cell in FILE MODE; for edit-ready structural addresses use find_text_occurrences.

Locate repeated visible text in FILE MODE so edits can be scoped, not guessed.

Named fields / {} placeholders are NOT required. Use this when the template is driven by repeated ▶, repeated ○○○, ordinary table cells, or paragraphs and you need structural addresses instead of a blind text replace. Repeated text must NOT be globally replaced without explicit scope; use the returned occurrences to choose exact structural targets, then send ONE addressed edits array (gather all values first) to preview_addressed_edits + apply_addressed_edits(session_id, out_path), or complete_addressed_template. Addressed file mode produces a completed copy and does not mutate the already-open same Hangul window.

Return the heading/outline structure of an HWPX document.

List body paragraphs with stable bN addresses for addressed edits.

Map tables with per-cell text and merge structure for label-to-cell reasoning.

Live COM availability probe — side-effect-free, never launches Hangul.

connected:false is the NORMAL idle state (no attach is attempted here); instances lists automation-visible Hangul instances in the COM ROT. Attach by exact path first (open_in_hwp(path)) or use the saved-.hwpx current-document flow (resolve -> preview -> apply).

Convert HWPX to HTML via python-hwpx (delegate extra required).

Convert HWPX to Markdown via python-hwpx (delegate).

Inspect FILE-MODE structural edit targets before any addressed/template write.

Named fields / {} placeholders are NOT required. Use these structural addresses for repeated ▶, repeated ○○○, ordinary table cells, and paragraphs when the template lacks reliable field names. Never treat repeated visible text as a global-replace target without explicit scope; send ONE addressed edits array (gather all values first) to preview_addressed_edits + apply_addressed_edits(session_id, out_path), or complete_addressed_template. The output is a completed copy and does not mutate the already-open same Hangul window — open it afterward.

List charPr/paraPr style definitions available in the document.

Delete table ROWS in the OPEN Hangul window (live-only; Windows + Hangul).

Offline row delete is unsafe (cellAddr/rowCnt/merge recompute), so this drives the open window — Hangul's TableSubtractRow recomputes merges. rows are tN.rN addresses (global table number, 0-based row), e.g. ["t2.r3"]. Plans purely first (fails closed on nested tables / unknown rows / duplicates), deletes bottom-up, and never opens/saves/closes the document. Cold start can take tens of seconds.

Generate one output per record from a template using the OWN byte-preserving fill engine.

Merge a table cell range (e.g. A1:B2) and write a NEW file (delegate).

Open a .hwp/.hwpx file in a CONTROLLABLE Hangul window.

Hand-opened windows are not a safe exact-path live-attach anchor on their own. Use this tool to attach by exact path in the automation-visible window first, then apply_to_open_hwp / apply_small_live_label_cells. Leaves the window open; saves and closes nothing. If Hangul is not running, this launches it — cold start can take tens of seconds (see cold_start/elapsed_seconds). timeout_seconds > 0 runs in an isolated worker and returns timeout_outcome_unknown (state may be partially applied).

Plan whole-template completion in FILE MODE and return addressable edit targets.

Named fields / {} placeholders are NOT required: repeated ▶, repeated ○○○, ordinary table cells, and paragraphs are addressed structurally. Never replace repeated text without explicit scope. Gather ALL values first, then hand one complete addressed edits array to complete_addressed_template instead of one tool call per cell — start in file mode instead of mixing live field writes. The completed copy does not mutate the already-open same Hangul window — open it afterward.

Resolve STRUCTURAL addressed edits in file mode without writing output.

edits do NOT require {} named fields. Use structural addresses for repeated "▶", repeated "○○○", ordinary table cells, and paragraphs. Repeated text must never be treated as a global replace; require explicit scope in the address. For whole-template completion, gather or generate all values first and prepare one edits array here instead of one tool call per cell. Start in file mode from the beginning instead of mixing live field writes and then falling back to file mode. Preview here first to confirm each edit resolves to the intended local target and returns the reviewed session that apply_addressed_edits(session_id, out_path) writes later as a completed copy. This addressed file-mode route does not mutate the already-open same Hangul window; open the verified output afterward if live review is needed.

Validate and preview three deterministic assessment variants without writing files.

Preview multiple find->replace pairs as one edit session without writing output.

Preview the saved current .hwpx document pathlessly without writing it.

Pass values for small live fills OR edits (structural addressed edits) for the complete_and_load route — never both. complete_and_load writes the whole-template completion to a NEW verified file (optional output_path, .hwpx, never the original) that apply opens as a new tab; the original document stays untouched and the new path is always returned. Saved .hwp returns preview_requires_hwpx; success returns the authoritative preview_token for apply_to_current_hwp_document.

Preview a text replace as an edit session (entry/count audit) without writing output.

Preview small live label:value cell fills WITHOUT COM or ROT access.

This is not whole-template completion. For a full lesson plan or other structured form, use compact inspect then complete_addressed_template(path, edits, out_path) or the complete_and_load route — the verified NEW file opens as a new tab and the original stays untouched (plain open_in_hwp may reuse the active tab). This pure preview does not probe COM ROT or attach candidates; exact-path attachment is deferred to apply_small_live_label_cells.

Render page PNG previews via python-hwpx + Playwright/Chromium (render extra).

Resolve the current/open Hangul document inventory without writing anything.

This is the side-effect-free entry point for the pathless current-document UX. It never auto-selects around an unsupported, unsaved, or unprovable current document.

Restore the pre-apply snapshot of an applied edit session (file-mode undo).

Scan extracted document text for Korean PII patterns and return masked findings.

One-shot text replace written to a NEW file; fails closed on 2+ matches unless scope='all'.

Set a table cell fill color and write a NEW file (delegate).

Set the body column count and write a NEW file (delegate).

Set the page footer text (page_type: BOTH/EVEN/ODD as accepted by python-hwpx) to a NEW file.

Set the page header text (page_type: BOTH/EVEN/ODD as accepted by python-hwpx) to a NEW file.

Set page margins (left/right/top/bottom/header/footer/gutter, HWPUNIT) to a NEW file (delegate).

Place page numbers (position e.g. BOTTOM_CENTER, as accepted by python-hwpx) to a NEW file.

Set paper width/height/orientation (e.g. PORTRAIT/LANDSCAPE) and write a NEW file (delegate).

Split a previously merged table cell apart and write a NEW file (delegate).

Validate HWPX package integrity (zip layout, mimetype, XML declarations); ok mirrors valid.

Verify expected label:value pairs actually appear in the (filled) document.

Verify expected_text at exact structural targets (tN.rN.cN[.pN] / bN) after edits.