Check if Adobe InDesign is reachable (app open, version, active document). Call first in a session before scan_document.

Scan the active InDesign document into the session Document Model cache and write stable mcp: labels. Call ONCE per session before planning edits; then use execute_batch (not repeated scans).

Invalidate and reload the Document Model from InDesign. Use only after manual edits in InDesign or when the cache may be stale — not before every mutation.

Return a summary of the cached Document Model without rescanning InDesign (unless forceRefresh or cache empty).

Read the current InDesign selection as stable UUIDs and sync them into the session cache.

Classify page items into semantic roles (Header, Subtitle, Body, Caption, Image, Background, Logo, Decorative, Unknown) and store them on the Document Model. Call after scan_document so batch targets like {role:"Header"} work. Typical flow: scan → analyze_page → execute_batch → summarize_changes.

Capture or inspect Document Model snapshots. Modes: before | after | list | diff. Capture uses the current session cache (run scan_document first).

Diff snapshot before vs after into agent-readable summary. Call after execute_batch (or layout_assistant fix). Defaults to the last before/after pair from scan_document + batch.

Dry-run a batch against the cached Document Model (no InDesign writes). Call after scan_document. Prefer preview_batch before a large execute_batch.

Preferred mutation path: resolve targets → checkpoint gate → one dispatcher round-trip inside a single ENTIRE_SCRIPT undo transaction → modelPatch on cache. ALWAYS prefer this over execute_operation / layout_operation when combining ops. Mutating batches need an on-disk checkpoint for the current generation; the server takes one automatically and refuses the batch if saving it fails. Typical flow: scan_document → (analyze_page) → execute_batch → summarize_changes.

Thin single-op wrapper around execute_batch (checkpoint/move/resize/delete/duplicate/setText/replaceText/setFont/setFill/applyStyle). op=checkpoint saves an .indd copy to _checkpoints/ next to the document and needs no target — run it before a risky sequence of edits. Prefer execute_batch when issuing two or more ops.

Layout helpers: align | distribute | center | stack | applyMargins. Thin wrapper — prefer execute_batch when combining with other ops. Requires scan_document; role targets need analyze_page.

Diagnose or fix page layout (overlapping/tight text, items outside margins). Modes: diagnose | preview | fix. Prefer after scan_document (+ analyze_page for title roles). Units are points. fix applies via execute_batch.

List paragraph / character / object styles from the Document Model cache (or refresh from InDesign). Prefer after scan_document; use apply_style / execute_batch applyStyle to apply.

Apply a paragraph, character, or object style to target item(s). Prefer execute_batch when combining with other ops.

Create a paragraph/character/object style (from selection item, basedOn, and/or font size spec).

Update an existing style definition (spec, basedOn, rename, or copy from an item).

List placed links/assets (path, status, page) from cache or refresh from InDesign.

Report missing / inaccessible / out-of-date links in the active document.

Relink a placed asset to a new file path on disk.

Replace a placed asset with another file (same as relink_asset).

Embed a linked asset into the document (unlink from disk).