adeu 3.2.0__tar.gz → 3.2.2__tar.gz

{adeu-3.2.0 → adeu-3.2.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: adeu
-Version: 3.2.0
+Version: 3.2.2
 Summary: Automated DOCX Redlining Engine
 Project-URL: Homepage, https://adeu.ai
 Project-URL: Repository, https://github.com/dealfluence/adeu
@@ -93,11 +93,14 @@ uvx adeu extract --live
 ```
 
 ### Diffing
-Generate a word-level patch diff between two document versions.
+Generate a word-level patch diff or a one-step redlined `.docx` comparison between two document versions.
 ```bash
-# Compare two DOCX files
+# Compare two DOCX files (@@ Word Patch @@ output)
 uvx adeu diff original.docx modified.docx
 
+# Write the comparison directly as a tracked-changes .docx in one step
+uvx adeu diff original.docx modified.docx -o redlined.docx --author "AI Reviewer"
+
 # Output raw JSON edits for programmatic use
 uvx adeu diff original.docx modified.docx --json
 ```
@@ -108,6 +111,9 @@ Apply a JSON array of `DocumentChange` objects (or a modified markdown file) bac
 # Apply a JSON batch of edits to a file
 uvx adeu apply original.docx edits.json --author "AI Reviewer" -o redlined.docx
 
+# Manual / inline formatting markup (strikethrough + bold red underline instead of Track Changes)
+uvx adeu apply original.docx edits.json --author "AI Reviewer" --manual -o manual.docx
+
 # Emit the batch result as machine-readable JSON on stdout (for agents/scripts)
 uvx adeu apply original.docx edits.json --json
 
@@ -173,14 +179,14 @@ The I/O contract (see `docs/cli-agent-spec.md` for the full specification):
   - `0` = success (in `--partial` mode, at least one edit applied; check `edits_skipped` in JSON stats to detect skipped edits)
   - `1` = failure (in atomic mode, if any edit fails; in `--partial` mode, if all edits fail)
 
-`adeu apply --json` prints the engine's raw stats object — `edits_applied`, `edits_skipped`, per-edit reports with CriticMarkup previews, plus `output_path` — and suppresses the human-readable logs. A batch that fails validation prints `{"error": "batch_validation_failed", "errors": [...]}` and exits 1.
+`adeu apply --json` prints the engine's raw stats object — `edits_applied`, `edits_skipped`, per-edit reports with CriticMarkup previews, plus `output_path` — and suppresses the human-readable logs. A batch that fails validation prints `{"error": "batch_validation_failed", "failed": [{"index", "reason"}, ...], "errors": [...]}` and exits 1.
 
 ## The Python SDK
 
 The SDK allows you to embed Adeu's Redline Engine directly into your own Python applications.
 
 ### Applying Tracked Changes
-The engine processes a flat list of `DocumentChange` objects (`ModifyText`, `AcceptChange`, `RejectChange`, `ReplyComment`, `InsertTableRow`, `DeleteTableRow`).
+The engine processes a flat list of `DocumentChange` objects (`ModifyText`, `SetField`, `AcceptChange`, `RejectChange`, `ReplyComment`, `InsertTableRow`, `DeleteTableRow`).
 
 ```python
 from io import BytesIO

{adeu-3.2.0 → adeu-3.2.2}/README.md

@@ -43,11 +43,14 @@ uvx adeu extract --live
 ```
 
 ### Diffing
-Generate a word-level patch diff between two document versions.
+Generate a word-level patch diff or a one-step redlined `.docx` comparison between two document versions.
 ```bash
-# Compare two DOCX files
+# Compare two DOCX files (@@ Word Patch @@ output)
 uvx adeu diff original.docx modified.docx
 
+# Write the comparison directly as a tracked-changes .docx in one step
+uvx adeu diff original.docx modified.docx -o redlined.docx --author "AI Reviewer"
+
 # Output raw JSON edits for programmatic use
 uvx adeu diff original.docx modified.docx --json
 ```
@@ -58,6 +61,9 @@ Apply a JSON array of `DocumentChange` objects (or a modified markdown file) bac
 # Apply a JSON batch of edits to a file
 uvx adeu apply original.docx edits.json --author "AI Reviewer" -o redlined.docx
 
+# Manual / inline formatting markup (strikethrough + bold red underline instead of Track Changes)
+uvx adeu apply original.docx edits.json --author "AI Reviewer" --manual -o manual.docx
+
 # Emit the batch result as machine-readable JSON on stdout (for agents/scripts)
 uvx adeu apply original.docx edits.json --json
 
@@ -123,14 +129,14 @@ The I/O contract (see `docs/cli-agent-spec.md` for the full specification):
   - `0` = success (in `--partial` mode, at least one edit applied; check `edits_skipped` in JSON stats to detect skipped edits)
   - `1` = failure (in atomic mode, if any edit fails; in `--partial` mode, if all edits fail)
 
-`adeu apply --json` prints the engine's raw stats object — `edits_applied`, `edits_skipped`, per-edit reports with CriticMarkup previews, plus `output_path` — and suppresses the human-readable logs. A batch that fails validation prints `{"error": "batch_validation_failed", "errors": [...]}` and exits 1.
+`adeu apply --json` prints the engine's raw stats object — `edits_applied`, `edits_skipped`, per-edit reports with CriticMarkup previews, plus `output_path` — and suppresses the human-readable logs. A batch that fails validation prints `{"error": "batch_validation_failed", "failed": [{"index", "reason"}, ...], "errors": [...]}` and exits 1.
 
 ## The Python SDK
 
 The SDK allows you to embed Adeu's Redline Engine directly into your own Python applications.
 
 ### Applying Tracked Changes
-The engine processes a flat list of `DocumentChange` objects (`ModifyText`, `AcceptChange`, `RejectChange`, `ReplyComment`, `InsertTableRow`, `DeleteTableRow`).
+The engine processes a flat list of `DocumentChange` objects (`ModifyText`, `SetField`, `AcceptChange`, `RejectChange`, `ReplyComment`, `InsertTableRow`, `DeleteTableRow`).
 
 ```python
 from io import BytesIO

{adeu-3.2.0 → adeu-3.2.2}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "adeu"
-version = "3.2.0"
+version = "3.2.2"
 description = "Automated DOCX Redlining Engine"
 authors = [
     { name = "Mikko Korpela" },

{adeu-3.2.0 → adeu-3.2.2}/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/dealfluence/adeu",
     "source": "github"
   },
-  "version": "3.2.0",
+  "version": "3.2.2",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@adeu/mcp-server",
-      "version": "3.2.0",
+      "version": "3.2.2",
       "transport": {
         "type": "stdio"
       }

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/cli.py

@@ -830,7 +830,13 @@ def handle_extract(args):
         # modes it must be a positive integer; anything else is a hard error,
         # never a silent fallback to page 1 (QA L1).
         page_num = 1
-        want_all_pages = False
+        # Writing to a file (`-o <path>`, where `-o -` was already normalized to
+        # None above) defaults to the full document when `--page` is omitted:
+        # synthetic pagination protects stdout/LLM context windows, whereas file
+        # extraction is expected to contain the whole document.
+        want_all_pages = bool(
+            args.page is None and args.output and args.mode == "full" and not getattr(args, "search_query", None)
+        )
         is_page_range = False
         range_start = 1
         range_end = 1
@@ -1064,7 +1070,29 @@ def handle_extract(args):
         # extracted text otherwise. stdout stays quiet either way — printing
         # the full payload again surprised pipeline users (QA 2026-07-18 L4).
         _write_output_or_exit(args.output, json_output if json_output is not None else output_text)
-        print(f"Extracted {'JSON' if json_output is not None else 'text'} to {args.output}", file=sys.stderr)
+        status_msg = f"Extracted {'JSON' if json_output is not None else 'text'} to {args.output}"
+        if not getattr(args, "search_query", None) and args.mode == "full" and not want_all_pages:
+            from adeu.pagination import PAGE_RANGE_MAX_PAGES, paginate, split_structural_appendix
+
+            total_pages = paginate(split_structural_appendix(text)[0], "").total_pages
+            if is_page_range:
+                shown_end = min(range_end, range_start + PAGE_RANGE_MAX_PAGES - 1, total_pages)
+                if range_start > 1 or shown_end < total_pages:
+                    status_msg = (
+                        f"Extracted pages {range_start}-{shown_end} of {total_pages} to {args.output} "
+                        "(partial extract; pass --page all for the full document)"
+                    )
+            elif total_pages > 1:
+                status_msg = (
+                    f"Extracted page {page_num} of {total_pages} to {args.output} "
+                    "(partial extract; pass --page all for the full document)"
+                )
+        elif args.mode == "appendix" and "Continues on appendix page " in output_text:
+            status_msg = (
+                f"Extracted appendix page {page_num} to {args.output} "
+                "(partial appendix extract; pass --page N for subsequent pages)"
+            )
+        print(status_msg, file=sys.stderr)
     elif json_output is not None:
         print(json_output)
     else:
@@ -1203,11 +1231,19 @@ def handle_diff(args):
         try:
             doc_orig = _load_docx_or_exit(args.original)
             text_orig, struct_orig = _extract_text_from_doc(
-                doc_orig, clean_view=compare_clean, include_appendix=False, return_structure=True
+                doc_orig,
+                clean_view=compare_clean,
+                include_appendix=False,
+                return_structure=True,
+                resolve_numbering=False,
             )
             doc_mod = _load_docx_or_exit(args.modified)
             text_mod, struct_mod = _extract_text_from_doc(
-                doc_mod, clean_view=compare_clean, include_appendix=False, return_structure=True
+                doc_mod,
+                clean_view=compare_clean,
+                include_appendix=False,
+                return_structure=True,
+                resolve_numbering=False,
             )
         except SystemExit:
             raise
@@ -2114,7 +2150,12 @@ def _main_impl():
         action="store_true",
         help=f"{live_help_prefix}Extract text from live active Word document",
     )
-    p_extract.add_argument("-o", "--output", type=Path, help="Output file ('-' or omitted: stdout)")
+    p_extract.add_argument(
+        "-o",
+        "--output",
+        type=Path,
+        help="Output file ('-' or omitted: stdout; defaults --page to 'all' in full mode when omitted)",
+    )
     p_extract.add_argument(
         "--force",
         action="store_true",
@@ -2159,11 +2200,10 @@ def _main_impl():
         type=str,
         default=None,
         help=(
-            "Page number (1-indexed) for 'full' and 'appendix' modes (defaults to 1), "
-            "or 'all' to emit the entire document in one output (mode 'full' and search). "
-            "Use '--page all' when producing a text file for `adeu apply`/`adeu diff` — "
-            "a single page of a multi-page document cannot round-trip. Note: pages are "
-            "synthetic, length-based content chunks sized for LLM consumption — they do "
+            "Page number (1-indexed) for 'full' and 'appendix' modes (defaults to 1 on stdout and 'all' "
+            "when writing to -o <file>), or 'all' to emit the entire document in one output (mode 'full' "
+            "and search). A single page of a multi-page document cannot round-trip into `adeu apply`/`adeu diff`. "
+            "Note: pages are synthetic, length-based content chunks sized for LLM consumption — they do "
             "NOT correspond to printed Word pages or explicit page breaks."
         ),
     )

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/compare.py

@@ -72,9 +72,11 @@ def refuse_input_alias(output_path: PathLike, original_path: PathLike, modified_
             )
 
 
-def apply_comparison_edits(original: bytes, edits: Sequence[DiffEdit], author: str) -> "tuple[bytes, int]":
+def apply_comparison_edits(
+    original: bytes, edits: Sequence[DiffEdit], author: str, resolve_numbering: bool = False
+) -> "tuple[bytes, int]":
     """Applies diff-generated edits to `original` as tracked changes; all of them or none."""
-    engine = RedlineEngine(BytesIO(original), author=author)
+    engine = RedlineEngine(BytesIO(original), author=author, resolve_numbering=resolve_numbering)
     applied, skipped = engine.apply_edits(list(edits))  # type: ignore[arg-type]
     if skipped:
         raise ComparisonError(
@@ -96,10 +98,18 @@ def build_redline_comparison(
     """Diffs two DOCX packages part by part and writes the result as a redline of `original`."""
     # Appendix excluded: its generated text is not writable content (QA 2026-07-18 H1).
     text_o, struct_o = _extract_text_from_doc(
-        Document(BytesIO(original)), clean_view=compare_clean, include_appendix=False, return_structure=True
+        Document(BytesIO(original)),
+        clean_view=compare_clean,
+        include_appendix=False,
+        return_structure=True,
+        resolve_numbering=False,
     )
     text_m, struct_m = _extract_text_from_doc(
-        Document(BytesIO(modified)), clean_view=compare_clean, include_appendix=False, return_structure=True
+        Document(BytesIO(modified)),
+        clean_view=compare_clean,
+        include_appendix=False,
+        return_structure=True,
+        resolve_numbering=False,
     )
     edits, warnings = generate_structured_edits(text_o, struct_o, text_m, struct_m)  # type: ignore[arg-type]
     warnings = list(warnings) + collect_media_difference_warnings(original, modified)

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/disk_cache.py

@@ -9,6 +9,9 @@ from typing import Any, Dict, List, Optional, Tuple, Union
 from adeu import __version__
 from adeu.outline import OutlineNode
 
+# Increment whenever Virtual Text projection rules change without a package version bump.
+_CACHE_SCHEMA_VERSION = 2
+
 
 def get_default_cache_dir() -> Path:
     if env_dir := os.environ.get("ADEU_CACHE_DIR"):
@@ -125,6 +128,7 @@ class DiskProjectionCache:
                 or key.get("mtime_ns") != mtime_ns
                 or key.get("size") != size
                 or key.get("version") != __version__
+                or key.get("schema") != _CACHE_SCHEMA_VERSION
             ):
                 self._misses += 1
                 return None
@@ -165,6 +169,7 @@ class DiskProjectionCache:
                 "mtime_ns": mtime_ns,
                 "size": size,
                 "version": __version__,
+                "schema": _CACHE_SCHEMA_VERSION,
             }
 
             data: Dict[str, Any] = {"key": key_dict, "views": {}}

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/ingest.py

@@ -25,6 +25,7 @@ from adeu.utils.content_controls import (
 )
 from adeu.utils.docx import (
     DocxEvent,
+    NumberingTracker,
     ProjectedRun,
     _get_style_cache,
     apply_formatting_to_segments,
@@ -95,6 +96,7 @@ def extract_text_from_stream(
     filename: str = "document.docx",
     clean_view: bool = False,
     include_appendix: bool = True,
+    resolve_numbering: bool = True,
 ) -> str:
     """
     Extracts text from a file stream using raw run concatenation.
@@ -106,6 +108,9 @@ def extract_text_from_stream(
         include_appendix: If False, omits the generated read-only structural
                     appendix — required whenever the text feeds a comparison
                     (QA 2026-07-18 H1).
+        resolve_numbering: If True (default), emits resolved OOXML clause/list
+                    numbers; if False, emits canonical '1. ' markers for
+                    DOCX-to-DOCX comparison.
 
     CRITICAL: This must match DocumentMapper._build_map logic exactly.
     """
@@ -114,7 +119,12 @@ def extract_text_from_stream(
 
         sanitized_bytes = strip_bom_from_docx_bytes(file_stream.read())
         doc = Document(io.BytesIO(sanitized_bytes))
-        return _extract_text_from_doc(doc, clean_view, include_appendix=include_appendix)
+        return _extract_text_from_doc(
+            doc,
+            clean_view,
+            include_appendix=include_appendix,
+            resolve_numbering=resolve_numbering,
+        )
     except Exception as e:
         logger.error(f"Text extraction failed: {e}", exc_info=True)
         raise ValueError(f"Could not extract text: {str(e)}") from e
@@ -126,6 +136,7 @@ def _extract_text_from_doc(
     include_appendix: bool = True,
     return_paragraph_offsets: bool = False,
     return_structure: bool = False,
+    resolve_numbering: bool = True,
 ):
     """
     Extracts text from an already-loaded python-docx Document.
@@ -177,6 +188,11 @@ def _extract_text_from_doc(
         # part_cursor accounts for the \n\n separator that will precede this part
         # in the final join, ensuring internal offsets align exactly.
         part_cursor = cursor + 2 if full_text else cursor
+        part_ref = getattr(part, "part", part)
+        part_style_cache, part_default_pstyle = _get_style_cache(part_ref)
+        numbering_tracker = NumberingTracker(
+            part_ref, style_cache=part_style_cache, resolve_numbering=resolve_numbering
+        )
         part_text = _extract_blocks(
             part,
             comments_map,
@@ -184,7 +200,12 @@ def _extract_text_from_doc(
             offset_map=offset_map,
             cursor=part_cursor,
             table_acc=structure.tables if structure is not None else None,
+            style_cache=part_style_cache,
+            default_pstyle=part_default_pstyle,
+            part=part_ref,
             sdt_infos=sdt_infos,
+            numbering_tracker=numbering_tracker,
+            resolve_numbering=resolve_numbering,
         )
         if part_text:
             if full_text:
@@ -223,6 +244,8 @@ def _extract_blocks(
     part: Any = None,
     sdt_infos: dict | None = None,
     in_cell: bool = False,
+    numbering_tracker: NumberingTracker | None = None,
+    resolve_numbering: bool = True,
 ) -> str:
     """
     Recursively extracts text from a container (Document, Cell, Header, etc.)
@@ -236,6 +259,8 @@ def _extract_blocks(
         part = getattr(container, "part", container)
     if style_cache is None:
         style_cache, default_pstyle = _get_style_cache(part)
+    if numbering_tracker is None:
+        numbering_tracker = NumberingTracker(part, style_cache=style_cache, resolve_numbering=resolve_numbering)
 
     blocks = []
     local_cursor = cursor
@@ -290,6 +315,8 @@ def _extract_blocks(
                 default_pstyle=default_pstyle,
                 part=part,
                 in_cell=in_cell,
+                numbering_tracker=numbering_tracker,
+                resolve_numbering=resolve_numbering,
             )
             if inner:
                 full = f"{open_tok}{inner}{close_tok}"
@@ -312,6 +339,9 @@ def _extract_blocks(
                 sdt_infos=sdt_infos,
                 style_cache=style_cache,
                 default_pstyle=default_pstyle,
+                part=part,
+                numbering_tracker=numbering_tracker,
+                resolve_numbering=resolve_numbering,
             )
             if fn_text:
                 blocks.append(fn_text)
@@ -324,7 +354,15 @@ def _extract_blocks(
                     local_cursor -= 2
         elif isinstance(item, Paragraph):
             p_elem = item._element
-            style_prefix = get_paragraph_prefix(p_elem, style_cache, default_pstyle, part=part)
+            num_snap = numbering_tracker.snapshot()
+            style_prefix = get_paragraph_prefix(
+                p_elem,
+                style_cache,
+                default_pstyle,
+                part=part,
+                numbering_tracker=numbering_tracker,
+                resolve_numbering=resolve_numbering,
+            )
             prefix = style_prefix
             if is_first_para and c_type == "FootnoteItem":
                 prefix = f"[^{container.note_type}-{container.id}]: " + prefix
@@ -345,6 +383,7 @@ def _extract_blocks(
                 # paragraph away; when nothing visible survives inside it,
                 # the accepted view must not render an empty container
                 # (QA round 3, finding 2.4).
+                numbering_tracker.restore(num_snap)
                 if not is_first_block:
                     local_cursor -= 2
                 is_first_para = False
@@ -375,6 +414,8 @@ def _extract_blocks(
                 style_cache=style_cache,
                 default_pstyle=default_pstyle,
                 part=part,
+                numbering_tracker=numbering_tracker,
+                resolve_numbering=resolve_numbering,
             )
             if table_text:
                 blocks.append(table_text)
@@ -402,6 +443,8 @@ def extract_table(
     default_pstyle: str | None = None,
     part: Any = None,
     sdt_infos: dict | None = None,
+    numbering_tracker: NumberingTracker | None = None,
+    resolve_numbering: bool = True,
 ) -> str:
     """
     Args:
@@ -463,6 +506,8 @@ def extract_table(
                 default_pstyle=default_pstyle,
                 part=part,
                 in_cell=True,
+                numbering_tracker=numbering_tracker,
+                resolve_numbering=resolve_numbering,
             )
             if cell_info is not None:
                 # Cell-level control (sdtContent > w:tc): anchors render inline

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/mcp_components/_response_builders.py

@@ -714,7 +714,7 @@ def build_search_response(
     search_query: str,
     search_regex: bool,
     search_case_sensitive: bool,
-    page: int | str | None,
+    page: int | str | tuple[int, int] | None,
     file_path: str,
     is_cli: bool = False,
     pagination_result: "PaginationResult | None" = None,

adeu-3.2.2/src/adeu/mcp_components/build_info.json

@@ -0,0 +1 @@
+{"git_sha": "03500b9", "build_timestamp": "20261111103826"}

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/mcp_components/tools/document.py

@@ -1004,10 +1004,18 @@ async def diff_docx_files(
         # diagnostics) is not document content — diffing it produces phantom
         # changes no apply can consume (QA 2026-07-18 H1).
         text_orig = extract_text_from_stream(
-            stream_orig, filename=Path(original_path).name, clean_view=compare_clean, include_appendix=False
+            stream_orig,
+            filename=Path(original_path).name,
+            clean_view=compare_clean,
+            include_appendix=False,
+            resolve_numbering=False,
         )
         text_mod = extract_text_from_stream(
-            stream_mod, filename=Path(modified_path).name, clean_view=compare_clean, include_appendix=False
+            stream_mod,
+            filename=Path(modified_path).name,
+            clean_view=compare_clean,
+            include_appendix=False,
+            resolve_numbering=False,
         )
         # atomic_criticmarkup: diff-display only — hunks must never cut into a
         # {--/{++/{>>/{== block (QA 2026-07-23 F15). No-op on clean text.
@@ -1381,11 +1389,14 @@ READ_DOCX_WIN32_EXTRA = (
 
 READ_DOCX_TAIL = (
     "Modes:\n"
-    "- 'full' (default): paginated body content. Use page=N to navigate.\n"
+    "- 'full' (default): paginated body content. `page`: 1-indexed int, 'N-M' range (up to 8 pages; "
+    "also filters `search_query`), or 'all' (serves first pages + L1 outline when over budget unless force=true).\n"
     "- 'outline': heading map only — start here for large docs to plan targeted reads. "
     "Defaults to L1-L2 headings; pass outline_max_level=3-6 to see deeper structure.\n"
     "- 'appendix': defined terms, anchors, and cross-reference targets. "
-    "Consult before editing legal/technical docs to avoid breaking references."
+    "Consult before editing legal/technical docs to avoid breaking references.\n"
+    "- 'changes': compact ledger of Tracked Changes (`Chg:N`) and Comments (`Com:N`).\n"
+    "- 'fields': ledger of form fields (content controls) with `CC:<N>` IDs (paginate via `fields_offset`)."
 )
 
 PROCESS_BATCH_COMMON_DESC = (
@@ -1431,20 +1442,21 @@ PROCESS_BATCH_WIN32_EXTRA = (
     "Leave original_docx_path empty to edit whatever document is currently active.\n\n"
 )
 PROCESS_BATCH_OPERATIONS_DESC = (
-    "Each item in `changes` must specify a `type`:\n"
+    "Changes by `type`:\n"
     "1. 'modify': Search-and-replace. `target_text` must uniquely match — add "
-    "context if ambiguous. `new_text` supports Markdown: '#'–'######' headings, "
-    "'**bold**', '_italic_', '\\n\\n' paragraph split. Empty `new_text` deletes. "
-    "Never write CriticMarkup ({++, {--, {>>) manually — use `comment`.\n"
-    "2. 'accept' / 'reject': Finalize or revert a tracked change by `target_id` (e.g. 'Chg:12'). "
-    "Ids are per package part: when one exists in several parts the bare id is refused; "
-    "add `part` (e.g. 'word/header1.xml').\n"
-    "3. 'reply': Reply to a comment by `target_id` (e.g. 'Com:5') with `text`.\n"
-    "4. 'set_field': Fill a content control (form field) — `field` is its 'CC:<N>' id, "
-    "tag or alias, `value` the text; list them with `read_docx` mode='fields'. Checkboxes "
-    "take true/false, dates YYYY-MM-DD, dropdowns a listed option. Data-bound controls "
-    "update their store too. A locked or protected control refuses and names the override "
-    "that permits it.\n"
+    "context, or set `match_mode` ('first'|'all') or `regex=true`. Empty table "
+    "cells emit `{#cell:<id>}` — pass that token as `target_text` to fill one. "
+    "`new_text` supports '#'–'######' headings, '**bold**', '_italic_', '\\n\\n' "
+    "paragraph split, and pipe tables (`| H1 | H2 |\\n|---|---|\\n| A | B |`). "
+    "Empty `new_text` deletes. Never write CriticMarkup ({++, {--, {>>) — use "
+    '`comment` (string or `[{"text": ..., "author": ...}]`).\n'
+    "2. 'accept' / 'reject': Finalize or revert by `target_id` ('Chg:12'); add "
+    "`part` ('word/header1.xml') when the same id exists in several parts.\n"
+    "3. 'reply': Reply to `target_id` ('Com:5') with `text`.\n"
+    "4. 'set_field': Fill a content control — `field` is 'CC:<N>', tag or alias, "
+    "`value` the text (checkboxes true/false, dates YYYY-MM-DD, dropdowns a listed "
+    "option; list via `read_docx` mode='fields'). Data-bound controls update their "
+    "store; locked/protected controls refuse and name the override.\n"
     "5. 'insert_row' / 'delete_row': Table edits. Disk mode only — not supported on Live Word canvas.\n\n"
     "ID VOLATILITY: 'Chg:N'/'Com:N' shift between document states — call "
     "`read_docx` before any accept/reject/reply; never reuse earlier ids.\n\n"

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/mcp_components/tools/live_word.py

@@ -382,13 +382,25 @@ if sys.platform == "win32":
                     from adeu.mcp_components._response_builders import (
                         build_search_response,
                     )
+                    from adeu.pagination import parse_page_arg as _parse_search_page
+
+                    search_page: int | str | tuple[int, int] | None = page
+                    if isinstance(page, str):
+                        s_clean = page.strip().strip("'\"")
+                        if "-" in s_clean:
+                            try:
+                                p_kind, p_val = _parse_search_page(s_clean)
+                                if p_kind == "range":
+                                    search_page = p_val
+                            except ValueError:
+                                pass
 
                     res = build_search_response(
                         final_text,
                         search_query,
                         search_regex,
                         search_case_sensitive,
-                        page,
+                        search_page,
                         actual_path,
                         max_matches=max_matches,
                         match_offset=match_offset,

{adeu-3.2.0 → adeu-3.2.2}/src/adeu/models.py

@@ -199,8 +199,10 @@ class ModifyText(_EditState):
     target_text: str = Field(
         ...,
         description=(
-            "Exact text to find. If the text appears multiple times (e.g. 'Fee'), include surrounding context. "
-            "You can include CriticMarkup {==...==} in the target to match text inside existing markup."
+            "Exact text to find. If the text appears multiple times (e.g. 'Fee'), include surrounding context, "
+            "or set match_mode='first'/'all'. Empty table cells emit `{#cell:<id>}` — pass that token as "
+            "target_text to fill one. You can include CriticMarkup {==...==} in the target to match text inside "
+            "existing markup."
         ),
     )
 
@@ -208,7 +210,8 @@ class ModifyText(_EditState):
         ...,
         description=(
             "The desired text replacement. You may use Markdown formatting: "
-            "'# Title' for headers, '**bold**' for bold, '_italic_' for italic. "
+            "'# Title' for headers, '**bold**' for bold, '_italic_' for italic, '\\n\\n' for paragraph breaks, "
+            "and pipe tables (`| Col 1 | Col 2 |\\n| --- | --- |\\n| A | B |`) to insert native Word tables. "
             "Do NOT manually write CriticMarkup tags ({++...++}, {--...--}, {>>...<<}, {==...==}). "
             "To add a comment, use the 'comment' parameter instead."
         ),
@@ -363,15 +366,18 @@ class FlatDocumentChange(BaseModel):
     target_text: Optional[str] = Field(
         None,
         description=(
-            "Exact text to find. If the text appears multiple times (e.g. 'Fee'), include surrounding context. "
-            "You can include CriticMarkup {==...==} in the target to match text inside existing markup."
+            "Exact text to find. If the text appears multiple times (e.g. 'Fee'), include surrounding context, "
+            "or set match_mode='first'/'all'. Empty table cells emit `{#cell:<id>}` — pass that token as "
+            "target_text to fill one. You can include CriticMarkup {==...==} in the target to match text inside "
+            "existing markup."
         ),
     )
     new_text: Optional[str] = Field(
         None,
         description=(
             "The desired text replacement. You may use Markdown formatting: "
-            "'# Title' for headers, '**bold**' for bold, '_italic_' for italic. "
+            "'# Title' for headers, '**bold**' for bold, '_italic_' for italic, '\\n\\n' for paragraph breaks, "
+            "and pipe tables (`| Col 1 | Col 2 |\\n| --- | --- |\\n| A | B |`) to insert native Word tables. "
             "Do NOT manually write CriticMarkup tags ({++...++}, {--...--}, {>>...<<}, {==...==}). "
             "To add a comment, use the 'comment' parameter instead."
         ),
@@ -394,6 +400,15 @@ class FlatDocumentChange(BaseModel):
         None,
         description="The full ID string from the document text (e.g. 'Chg:12', 'Com:5').",
     )
+    part: Optional[str] = Field(
+        None,
+        description=(
+            "accept / reject only: OPC part holding the change, e.g. 'word/header1.xml'. "
+            "Revision ids are numbered per part, so the same Chg:N can name unrelated changes in "
+            "different parts; a bare ambiguous id is refused with an error listing the parts, and "
+            "this field picks one. Omit whenever the id is unique in the package."
+        ),
+    )
     text: Optional[str] = Field(
         None,
         description="The content of the reply body.",