python-hwpx-automation 7.3.2__py3-none-any.whl → 7.3.3__py3-none-any.whl

hwpx_automation/core/content.py

@@ -14,8 +14,15 @@ from uuid import uuid4
 from xml.etree import ElementTree as ET
 
 from ..compat import patch_python_hwpx
-from ..storage import build_hwpx_open_safety_report
-from ..upstream import HP_NS as _HP_NS, HwpxDocument, repair_pathological_text_spacing
+from ..storage import build_hwpx_open_safety_report, open_local_document
+from ..upstream import (
+    HP_NS as _HP_NS,
+    HwpxDocument,
+    is_hwp5_source,
+    is_hwp5_target,
+    repair_pathological_text_spacing,
+)
+from .document import save_doc
 from .formatting import resolve_style_id
 from .locations import resolve_paragraph_reference
 
@@ -500,6 +507,15 @@ def copy_document_file(source: str, destination: str = None) -> str:
         destination = f"{stem}_copy.{ext}"
     source_path = Path(source)
     destination_path = Path(destination)
+    if is_hwp5_source(source_path) != is_hwp5_target(destination_path):
+        # The destination extension picks the format, so a copy between .hwp
+        # and .hwpx is written through the document model, not byte-copied.
+        document = open_local_document(source_path, role="copy source")
+        try:
+            save_doc(document, str(destination_path))
+        finally:
+            document.close()
+        return str(destination_path)
     if source_path.suffix.lower() != ".hwpx" and destination_path.suffix.lower() != ".hwpx":
         shutil.copy2(source_path, destination_path)
         return str(destination_path)

hwpx_automation/core/document.py

@@ -5,7 +5,7 @@ from pathlib import Path
 from typing import Any
 
 from ..configuration import env_value
-from ..storage import LocalDocumentStorage, require_hwpx_editor_open_safe
+from ..storage import LocalDocumentStorage, open_local_document
 from ..upstream import HwpxDocument, blank_document_template_bytes, open_document
 
 
@@ -18,8 +18,7 @@ def _local_storage() -> LocalDocumentStorage:
 def open_doc(path: str) -> HwpxDocument:
     if not os.path.exists(path):
         raise FileNotFoundError(f"파일을 찾을 수 없습니다: {path}")
-    require_hwpx_editor_open_safe(Path(path), role="local HWPX open")
-    return open_document(path)
+    return open_local_document(Path(path), role="local HWPX open")
 
 
 def save_doc(doc: HwpxDocument, path: str, *, quality: Any = None) -> dict[str, Any]:

hwpx_automation/core/transactions.py

@@ -12,8 +12,12 @@ from pathlib import Path
 from typing import Any, Iterable
 
 from .. import quality as quality_contract
-from ..storage import build_hwpx_verification_report, require_hwpx_editor_open_safe
-from ..upstream import HwpxDocument, open_document
+from ..storage import (
+    build_hwpx_verification_report,
+    require_hwpx_editor_open_safe,
+    require_native_hwp5,
+)
+from ..upstream import HwpxDocument, hwp5_document_bytes, is_hwp5_target, open_document
 
 _MAX_SUMMARY_ITEMS = 20
 _MAX_SNIPPET = 80
@@ -341,9 +345,13 @@ def save_dry_run(
     document: HwpxDocument, target: str | Path, *, quality: Any = None
 ) -> dict[str, Any]:
     target_path = Path(target)
+    hwp_target = is_hwp5_target(target_path)
+    if hwp_target:
+        require_native_hwp5()
+    # The gate checks HWPX parts, so an .hwp target is staged as HWPX.
     fd, tmp_name = tempfile.mkstemp(
         prefix=f".{target_path.stem}.dry-run.",
-        suffix=target_path.suffix or ".hwpx",
+        suffix=".hwpx" if hwp_target else (target_path.suffix or ".hwpx"),
         dir=str(target_path.parent),
     )
     tmp_path = Path(tmp_name)
@@ -366,6 +374,10 @@ def save_dry_run(
                 "dry-run HWPX failed open-safety verification: "
                 + verification["openSafety"]["summary"]
             )
+        if hwp_target:
+            # Raises Hwp5Error (hwp5-write-unsupported) as the real save would.
+            hwp5_document_bytes(document)
+            verification["format"] = "hwp"
         diff = semantic_diff(target_path, tmp_path) if target_path.exists() else None
         verification["filePath"] = str(target_path)
         verification["dryRunTempDeleted"] = True

hwpx_automation/errors.py

@@ -73,6 +73,7 @@ DEFAULT_ERROR_SUGGESTIONS: dict[str, str] = {
     "EMPTY_MATCH": "찾을 텍스트나 앵커 조건을 실제 문서 내용에 맞게 수정하세요.",
     "HWP_CONVERSION_FAILED": "원본 HWP가 손상되지 않았는지 확인하고 변환 로그의 원인을 기준으로 다시 시도하세요.",
     "HWP_TEXT_EXTRACT_FAILED": "HWP 파일을 다른 뷰어에서 열어 유효성을 확인한 뒤 텍스트 추출을 다시 실행하세요.",
+    "HWPX_PACKAGE_REQUIRED": "copy_document로 .hwpx 사본을 만들어 이 도구를 쓰고, .hwp가 필요하면 결과를 copy_document로 .hwp 경로에 복사하세요. search_and_replace·set_table_cell_text 같은 문서 편집 도구는 .hwp를 그대로 편집합니다.",
     "IDEMPOTENT_REPLAY": "이미 적용된 planId입니다. 최신 preview/plan을 새로 만든 뒤 apply를 다시 호출하세요.",
     "MEMO_NOT_FOUND": "list_memos 또는 문서 리소스에서 memoId를 다시 확인한 뒤 호출하세요.",
     "MISSING_NODE": "대상 섹션, 문단, 표, 셀이 아직 존재하는지 조회한 뒤 새 앵커로 다시 실행하세요.",
@@ -81,7 +82,10 @@ DEFAULT_ERROR_SUGGESTIONS: dict[str, str] = {
     "PIPELINE_ERROR": "details.pipelineCode와 hint를 확인한 뒤 preview부터 다시 생성하세요.",
     "PLAN_RECORD_MISSING": "preview_edit 또는 plan_edit으로 planId를 새로 발급받은 뒤 apply를 다시 호출하세요.",
     "PREVIEW_REQUIRED": "preview_edit으로 변경 내용을 확인한 뒤 반환된 planId로 apply_edit을 호출하세요.",
-    "READ_ONLY_HWP_DOCUMENT": "HWP 바이너리는 직접 저장할 수 없습니다. 먼저 HWPX로 변환한 뒤 편집하세요.",
+    "HWP_DOCUMENT_UNREADABLE": "한/글에서 문서를 열어 다시 저장한 뒤 사용하세요. details.hwp5Code가 원인입니다.",
+    "HWP_ENCRYPTED_DOCUMENT": "한/글에서 문서 암호·배포용 보호를 풀고 다시 저장한 뒤 사용하세요. DRM 문서는 열 수 없습니다.",
+    "HWP_WRITE_UNSUPPORTED": "HWP 5.0으로 쓸 수 없는 내용이 있습니다. 출력 경로를 .hwpx로 지정해 저장하세요.",
+    "READ_ONLY_HWP_DOCUMENT": "python-hwpx 6.6.0 이상을 설치하면 .hwp 문서를 그대로 열고 편집·저장할 수 있습니다.",
     "RENDER_PREVIEW_INVALID_MODE": "mode는 'pages' 또는 'long'으로 지정한 뒤 다시 실행하세요.",
     "RENDER_PREVIEW_INVALID_SCREENSHOT_MODE": "screenshot은 'auto', 'require', 'off' 중 하나로 지정하세요.",
     "RENDER_PREVIEW_UNAVAILABLE": "matching python-hwpx 버전을 설치하고 MCP 서버를 새로 시작한 뒤 다시 실행하세요.",
@@ -175,3 +179,52 @@ def build_error_payload(
         suggestion=suggestion
         or suggestion_for_error(code, details=details, hint=hint),
     ).model_dump(exclude_none=True, by_alias=True)
+
+
+class HwpDocumentError(RuntimeError):
+    """An ``.hwp`` request the installed engine cannot carry out."""
+
+    def __init__(
+        self, message: str, *, code: str, details: Optional[Dict[str, Any]] = None
+    ) -> None:
+        super().__init__(message)
+        self.code = code
+        self.message = message
+        self.details = details
+
+    def to_payload(self) -> Dict[str, Any]:
+        return build_error_payload(
+            code=self.code, message=self.message, details=self.details
+        )
+
+
+_HWP5_ENCRYPTED_CODES = frozenset({"hwp5-password", "hwp5-distribution", "hwp5-drm"})
+
+
+def hwp5_error_payload(exc: BaseException) -> Optional[Dict[str, Any]]:
+    """The MCP error for python-hwpx's ``Hwp5Error``; None for any other exception.
+
+    Matched by its ``hwp5-*`` code so this module needs no core import.
+    """
+
+    hwp5_code = getattr(exc, "code", None)
+    if not isinstance(hwp5_code, str) or not hwp5_code.startswith("hwp5-"):
+        return None
+    details = {"hwp5Code": hwp5_code}
+    if hwp5_code == "hwp5-write-unsupported":
+        return build_error_payload(
+            code="HWP_WRITE_UNSUPPORTED",
+            message="문서에 HWP 5.0(.hwp)으로 쓸 수 없는 내용이 있어 아무것도 저장하지 않았습니다.",
+            details=details,
+        )
+    if hwp5_code in _HWP5_ENCRYPTED_CODES:
+        return build_error_payload(
+            code="HWP_ENCRYPTED_DOCUMENT",
+            message="암호·배포용·DRM으로 보호된 HWP 문서는 열 수 없습니다.",
+            details=details,
+        )
+    return build_error_payload(
+        code="HWP_DOCUMENT_UNREADABLE",
+        message="HWP 5.0(.hwp) 문서를 읽을 수 없습니다.",
+        details=details,
+    )

hwpx_automation/handlers/agent_document.py

@@ -9,6 +9,8 @@ from typing import Any
 
 
 from ..document_state import document_state_payload
+from ..errors import HwpDocumentError
+from ..storage import require_hwpx_package
 from ..agent_document import (
     AgentChildLimit,
     AgentCommandList,
@@ -100,6 +102,7 @@ def apply_document_commands(
     try:
         resolved_input = resolve_path(filename)
         resolved_output = resolve_path(output)
+        require_hwpx_package(resolved_input, output=resolved_output)
         quality_contract.assert_write_capability()
         store = ScopedIdempotencyStore(
             RUNTIME_SERVICES.idempotency_cache,
@@ -132,6 +135,8 @@ def apply_document_commands(
         if Path(state_path).exists():
             payload.update(document_state_payload(state_path))
         return payload
+    except HwpDocumentError:
+        raise
     except Exception as exc:
         return agent_batch_error_payload(
             exc,

hwpx_automation/handlers/read_export.py

@@ -35,6 +35,7 @@ from ..office.compliance import DEFAULT_POLICY, mask_pii
 from ..runtime_services import RUNTIME_SERVICES
 from ..upstream import (
     HP_NS,
+    hwp5_conversion_report,
     open_document,
 )
 from ..utils.helpers import default_max_chars, resolve_path, truncate_response
@@ -777,16 +778,19 @@ def get_document_info(filename: str) -> dict:
     path = resolve_path(filename)
     doc = open_doc(path)
     file_size = Path(path).stat().st_size
-    return _with_document_state(
-        {
-            "filename": filename,
-            "sections": len(doc.sections),
-            "paragraphs": _paragraph_count(doc),
-            "tables": _table_count(doc),
-            "file_size": str(file_size),
-        },
-        path,
-    )
+    info: dict[str, Any] = {
+        "filename": filename,
+        "sections": len(doc.sections),
+        "paragraphs": _paragraph_count(doc),
+        "tables": _table_count(doc),
+        "file_size": str(file_size),
+    }
+    conversion = hwp5_conversion_report(doc)
+    if conversion is not None:
+        # An .hwp is edited through the document model; this is what it left out.
+        info["format"] = "hwp"
+        info["hwpConversion"] = conversion
+    return _with_document_state(info, path)
 
 
 def get_document_text(

hwpx_automation/identity.json

@@ -7,9 +7,9 @@
     "candidate": {
       "pythonHwpx": "6.6.0",
       "canonicalDistribution": "python-hwpx-automation",
-      "canonicalAutomation": "7.3.2",
+      "canonicalAutomation": "7.3.3",
       "compatibilityDistribution": "hwpx-mcp-server",
-      "compatibility": "7.3.2",
+      "compatibility": "7.3.3",
       "plugin": "2.4.0",
       "contractHash": "5e5c23651f92785a"
     },

hwpx_automation/mixed_form.py

@@ -41,7 +41,7 @@ from pydantic import (
 from .execution_lock import PUBLIC_MUTATION_LOCK
 from .office.agent._batch_publication import GuardedSavePipeline
 from .office.rendering import resolve_hancom_backend
-from .storage import build_hwpx_open_safety_report
+from .storage import build_hwpx_open_safety_report, require_hwpx_package
 from .utils.helpers import resolve_path
 from .workspace import (
     WorkspaceMissingParentGuard,
@@ -1374,6 +1374,7 @@ def analyze_mixed_form_plan(
 
     request = _authorize_public_plan(_payload(plan, apply=False))
     source = Path(request["source"])
+    require_hwpx_package(source, output=request["output"])
     source_snapshot = _capture_path_snapshot(source)
     if source_snapshot.data is None:
         raise FileNotFoundError(source)
@@ -1494,6 +1495,7 @@ def _apply_canonical_mixed_form_plan_locked(
 
     compiled = validate_mixed_form_plan(compiled).to_dict()
     source, output = _authorize_compiled_plan(compiled)
+    require_hwpx_package(source, output=output)
     source_snapshot = _capture_path_snapshot(source)
     if source_snapshot.data is None:  # pragma: no cover - compiled plan invariant
         raise FileNotFoundError(source)

hwpx_automation/office/rendering/oracle.py

@@ -149,6 +149,16 @@ def _complete_package(path: str) -> bool:
         return False
 
 
+def _unchanged(path: str, before: os.stat_result) -> bool:
+    """True when ``path`` still has the size and modification time in ``before``."""
+
+    try:
+        now = os.stat(path)
+    except OSError:
+        return False
+    return (now.st_size, now.st_mtime_ns) == (before.st_size, before.st_mtime_ns)
+
+
 def _promote_file(staged: str, target: str) -> None:
     """Move a finished file to ``target`` without leaving a partial ``target``.
 
@@ -442,6 +452,8 @@ class WindowsComOracle(RenderBackend):
         by a complete package: a failed refresh leaves it as it was. Returns
         True when the file was re-saved. Only an ``.hwpx`` file is refreshed
         (Hancom saves it as HWPX), and a link is followed to the file it names.
+        A document that changed while Hancom ran (size or modification time)
+        is not overwritten: the refresh returns False and the change stays.
         """
 
         src = os.path.realpath(hwpx_path)
@@ -459,6 +471,7 @@ class WindowsComOracle(RenderBackend):
             try:
                 os.makedirs(os.path.dirname(job_src))
                 os.makedirs(os.path.dirname(job_out))
+                before = os.stat(src)
                 shutil.copyfile(src, job_src)
             except OSError:
                 return False
@@ -467,6 +480,8 @@ class WindowsComOracle(RenderBackend):
             entry = entries[0] if entries else None
             if not (isinstance(entry, dict) and entry.get("saved") and _complete_package(job_out)):
                 return False
+            if not _unchanged(src, before):
+                return False
             try:
                 _promote_file(job_out, src)
             except OSError:

hwpx_automation/ops_services/context.py

@@ -4,13 +4,16 @@ from __future__ import annotations
 
 import hashlib
 import logging
+from io import BytesIO
 from pathlib import Path
+from zipfile import ZipFile
 from typing import Any, Callable, Dict, List, Optional, Tuple
 
+from ..errors import HwpDocumentError, hwp5_error_payload
 from ..hwp_support import HwpBinaryError, extract_hwp_text
 from ..core.locator import RegisteredHandle
 from ..core.context import default_session_lifecycle_policy
-from ..storage import DocumentStorage, LocalDocumentStorage
+from ..storage import DocumentStorage, LocalDocumentStorage, require_hwpx_package
 from ..workspace import (
     WorkspacePathError,
 )
@@ -18,6 +21,8 @@ from ..upstream import (
     HwpxDocument,
     HwpxOxmlParagraph,
     HwpxOxmlTable,
+    hwpx_view_bytes,
+    native_hwp5_supported,
 )
 
 logger = logging.getLogger("hwpx_automation.hwpx_ops")
@@ -158,12 +163,50 @@ class DocumentContext:
     def _relative_path(self, path: Path) -> str:
         return self.storage.relative_path(path)
 
+    def _is_legacy_hwp(self, resolved: Path) -> bool:
+        """An ``.hwp`` the installed core cannot open; only its preview text is readable."""
+
+        return resolved.suffix.lower() == ".hwp" and not native_hwp5_supported()
+
+    def _text_source(self, resolved: Path) -> Path | ZipFile:
+        """What the text extractor reads: the HWPX file, or an ``.hwp``'s HWPX model."""
+
+        if resolved.suffix.lower() != ".hwp":
+            return resolved
+        try:
+            return ZipFile(BytesIO(hwpx_view_bytes(resolved)))
+        except Exception as exc:
+            hwp_error = self._hwp_error(exc)
+            if hwp_error is None:
+                raise
+            raise hwp_error from exc
+
+    def _hwp_error(self, exc: BaseException) -> Optional[RuntimeError]:
+        """The operation error for an ``.hwp`` refusal, or None for any other failure."""
+
+        if isinstance(exc, HwpDocumentError):
+            return self._new_error(exc.code, exc.message, details=exc.details)
+        payload = hwp5_error_payload(exc)
+        if payload is None:
+            return None
+        return self._new_error(
+            payload["code"], payload["message"], details=payload.get("details")
+        )
+
+    def _require_hwpx_package(self, source: Path, output: Optional[str] = None) -> None:
+        """Refuse ``.hwp`` for editors that patch HWPX package bytes."""
+
+        try:
+            require_hwpx_package(source, output=output)
+        except HwpDocumentError as exc:
+            raise self._new_error(exc.code, exc.message, details=exc.details) from exc
+
     def _open_document(self, path: str) -> Tuple[HwpxDocument, Path]:
         resolved = self._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._is_legacy_hwp(resolved):
             raise self._new_error(
                 "READ_ONLY_HWP_DOCUMENT",
-                "HWP 파일은 편집이 불가합니다. 먼저 convert_hwp_to_hwpx 도구로 HWPX 변환 후 편집하세요.",
+                "설치된 python-hwpx는 HWP 5.0(.hwp) 문서를 열거나 저장하지 못합니다.",
             )
         try:
             document, resolved = self.storage.open_document(path)
@@ -186,6 +229,9 @@ class DocumentContext:
                 details={"requestedName": Path(path).name},
             ) from exc
         except Exception as exc:  # pragma: no cover - delegated to backend
+            hwp_error = self._hwp_error(exc)
+            if hwp_error is not None:
+                raise hwp_error from exc
             raise self._new_error(
                 "DOCUMENT_OPEN_FAILED",
                 f"failed to open '{path}': {exc}",

hwpx_automation/ops_services/form_fields.py

@@ -299,6 +299,7 @@ class FormFieldService:
             ) from exc
 
         source_path = self._context._resolve_path(path)
+        self._context._require_hwpx_package(source_path, output)
         output_precondition = None
         if isinstance(self._context.storage, LocalDocumentStorage):
             output_precondition = (
@@ -468,6 +469,7 @@ class FormFieldService:
                 "installed python-hwpx does not provide hwpx.body_patch.apply_body_ops",
             ) from exc
         source_path = self._context._resolve_path(path)
+        self._context._require_hwpx_package(source_path, output)
         output_precondition = None
         if isinstance(self._context.storage, LocalDocumentStorage):
             output_precondition = (
@@ -633,6 +635,7 @@ class FormFieldService:
             ) from exc
 
         blank = self._context._resolve_path(path)
+        self._context._require_hwpx_package(blank, output)
         md = self._context._resolve_path(review_md)
         output_precondition = None
         if isinstance(self._context.storage, LocalDocumentStorage):

hwpx_automation/ops_services/package_validation.py

@@ -135,7 +135,7 @@ class PackageValidationService:
         resolved = self._context._resolve_path(path)
         patterns = [re.compile(pat) for pat in (forbid_patterns or [])]
         warnings: List[Dict[str, Any]] = []
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             for paragraph in extractor.iter_document_paragraphs():
                 text = paragraph.text()
                 if max_line_len is not None and len(text) > max_line_len:

hwpx_automation/ops_services/planning.py

@@ -39,7 +39,7 @@ class PlanningService:
     def _ensure_planner_document(self, doc_id: str, path: str) -> None:
         resolved = self._context._resolve_path(path)
         paragraphs: List[str] = []
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             for paragraph in extractor.iter_document_paragraphs():
                 paragraphs.append(paragraph.text(preserve_breaks=True))
         self._manager.register_document(doc_id, "\n".join(paragraphs))

hwpx_automation/ops_services/read_query.py

@@ -18,6 +18,7 @@ from ..upstream import (
     AnnotationOptions,
     create_object_finder,
     create_text_extractor,
+    hwp5_conversion_report,
 )
 
 from .context import DocumentContext
@@ -45,7 +46,7 @@ class ReadQueryService:
     def get_paragraphs_by_handle(self, handle_id: str) -> Dict[str, Any]:
         handle = self._context.get_registered_handle(handle_id)
         resolved = self._context._resolve_path(handle.path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, _ = self._context._read_only_hwp_paragraphs(handle.path)
             hwp_serialized = [
                 ParagraphResourceEntry(paragraphIndex=index, text=text)
@@ -57,7 +58,7 @@ class ReadQueryService:
             return model.model_dump(by_alias=True)
 
         serialized: List[ParagraphResourceEntry] = []
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             for paragraph in extractor.iter_document_paragraphs():
                 serialized.append(
                     ParagraphResourceEntry(
@@ -73,7 +74,7 @@ class ReadQueryService:
     def get_tables_by_handle(self, handle_id: str) -> Dict[str, Any]:
         handle = self._context.get_registered_handle(handle_id)
         resolved = self._context._resolve_path(handle.path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             model = DocumentTablesResource(handleId=handle.handle_id, tables=[])
             return model.model_dump(by_alias=True)
 
@@ -92,7 +93,7 @@ class ReadQueryService:
 
     def open_info(self, path: str) -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, source = self._context._read_only_hwp_paragraphs(path)
             stat = resolved.stat()
             meta = {
@@ -123,6 +124,10 @@ class ReadQueryService:
             "size": stat.st_size,
             "modified": datetime.fromtimestamp(stat.st_mtime).isoformat(),
         }
+        conversion = hwp5_conversion_report(document)
+        if conversion is not None:
+            meta["format"] = "hwp"
+            meta["hwpConversion"] = conversion
         return {
             "meta": meta,
             "sectionCount": section_count,
@@ -169,7 +174,7 @@ class ReadQueryService:
         with_footnotes: bool = False,
     ) -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             hwp_paragraphs, _, _ = self._context._read_only_hwp_paragraphs(path)
             effective_limit = (
                 self._context.paging_limit if limit is None else max(1, limit)
@@ -195,7 +200,7 @@ class ReadQueryService:
         paragraphs: List[str] = []
         next_offset: Optional[int] = None
         start = max(0, offset)
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             paragraph_iter = extractor.iter_document_paragraphs()
             sentinel = object()
 
@@ -239,7 +244,7 @@ class ReadQueryService:
             unique_indexes.add(int(index))
 
         resolved = self._context._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, _ = self._context._read_only_hwp_paragraphs(path)
             hwp_collected = {
                 idx: paragraphs[idx] for idx in unique_indexes if idx < len(paragraphs)
@@ -266,7 +271,7 @@ class ReadQueryService:
             )
 
         collected: Dict[int, str] = {}
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             for paragraph in extractor.iter_document_paragraphs():
                 para_index = paragraph.index
                 if para_index in unique_indexes and para_index not in collected:
@@ -292,7 +297,7 @@ class ReadQueryService:
 
     def text_extract_report(self, path: str, mode: str = "plain") -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, source = self._context._read_only_hwp_paragraphs(path)
             return {
                 "content": "\n".join(paragraphs)
@@ -307,7 +312,7 @@ class ReadQueryService:
                 endnote="inline",
                 control="placeholder",
             )
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             content = extractor.extract_text(
                 annotations=annotations,
                 include_nested=True,
@@ -322,11 +327,11 @@ class ReadQueryService:
         lock_keywords: Optional[Sequence[str]] = None,
     ) -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, source = self._context._read_only_hwp_paragraphs(path)
         else:
             paragraphs = []
-            with create_text_extractor(resolved) as extractor:
+            with create_text_extractor(self._context._text_source(resolved)) as extractor:
                 for paragraph in extractor.iter_document_paragraphs():
                     paragraphs.append(paragraph.text(preserve_breaks=True))
             source = "hwpx.text_extractor"
@@ -474,7 +479,7 @@ class ReadQueryService:
             return snippet
 
         pattern = re.compile(query) if is_regex else None
-        if resolved.suffix.lower() == ".hwp":
+        if self._context._is_legacy_hwp(resolved):
             paragraphs, _, _ = self._context._read_only_hwp_paragraphs(path)
             for para_index, text in enumerate(paragraphs):
                 if is_regex:
@@ -512,7 +517,7 @@ class ReadQueryService:
                         start = found + len(query)
             return {"matches": matches}
 
-        with create_text_extractor(resolved) as extractor:
+        with create_text_extractor(self._context._text_source(resolved)) as extractor:
             for paragraph in extractor.iter_document_paragraphs():
                 text = paragraph.text()
                 if is_regex:
@@ -558,7 +563,7 @@ class ReadQueryService:
         max_results: int = 200,
     ) -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        finder = create_object_finder(resolved)
+        finder = create_object_finder(self._context._text_source(resolved))
         objects = []
         for found in finder.iter(tag=tag_name, limit=max_results):
             element = found.element
@@ -582,7 +587,7 @@ class ReadQueryService:
         max_results: int = 200,
     ) -> Dict[str, Any]:
         resolved = self._context._resolve_path(path)
-        finder = create_object_finder(resolved)
+        finder = create_object_finder(self._context._text_source(resolved))
         tag_filter = None if element_type in {None, "", "*"} else element_type
         attr_matcher: Any = value if value is not None else (lambda _: True)
         objects = []

hwpx_automation/ops_services/save_policy.py

@@ -108,6 +108,9 @@ class SavePolicy:
                 details={"path": str(target)},
             ) from exc
         except Exception as exc:  # pragma: no cover - delegated to backend
+            hwp_error = self._context._hwp_error(exc)
+            if hwp_error is not None:
+                raise hwp_error from exc
             raise self._context._new_error(
                 "DOCUMENT_SAVE_FAILED",
                 f"failed to save '{target}': {exc}",

hwpx_automation/ops_services/transactions.py

@@ -427,6 +427,7 @@ class TransactionService:
             ) from exc
 
         source_path = self._context._resolve_path(path)
+        self._context._require_hwpx_package(source_path, output)
         output_precondition = None
         if isinstance(self._context.storage, LocalDocumentStorage):
             output_precondition = self._context.storage.capture_output_precondition(

hwpx_automation/runtime.py

@@ -5,6 +5,7 @@ from __future__ import annotations
 
 import json
 import re
+import zipfile
 from typing import Any, cast
 
 import mcp.types as mcp_types
@@ -17,7 +18,12 @@ from hwpx_automation.office.agent.model import RECOVERABILITY
 from . import __version__
 from . import quality as quality_contract
 from .configuration import env_value
-from .errors import build_error_payload, mcp_code_for_error
+from .errors import (
+    HwpDocumentError,
+    build_error_payload,
+    hwp5_error_payload,
+    mcp_code_for_error,
+)
 from .fastmcp_adapter import configure_runtime
 from .hwpx_ops import HwpxOperationError
 from .network_policy import NetworkPolicyError
@@ -81,11 +87,28 @@ def _exception_chain(exc: BaseException) -> list[BaseException]:
     return chain
 
 
+def _document_error_payload(item: BaseException) -> dict[str, Any] | None:
+    """The payload for an operation, ``.hwp`` or non-package failure; else None."""
+
+    if isinstance(item, (HwpxOperationError, HwpDocumentError)):
+        return item.to_payload()
+    hwp5_payload = hwp5_error_payload(item)
+    if hwp5_payload is not None:
+        return hwp5_payload
+    if isinstance(item, zipfile.BadZipFile):
+        return build_error_payload(
+            code="HWPX_PACKAGE_REQUIRED",
+            message="이 도구는 HWPX 패키지(ZIP)를 읽는데, 대상 파일은 HWPX 패키지가 아닙니다.",
+        )
+    return None
+
+
 def _classified_error_payload(exc: BaseException | None) -> dict[str, Any]:
     if exc is not None:
         for item in _exception_chain(exc):
-            if isinstance(item, HwpxOperationError):
-                return item.to_payload()
+            document_payload = _document_error_payload(item)
+            if document_payload is not None:
+                return document_payload
             if isinstance(item, AgentContractError):
                 return build_error_payload(
                     code=item.code,

hwpx_automation/storage.py

@@ -32,7 +32,18 @@ else:
     _OPEN_SAFETY_CLASSIFIER_IMPORT_ERROR = None
 
 from . import quality as quality_contract
-from .upstream import HwpxDocument, open_document, validate_document_path
+from .errors import HwpDocumentError
+from .upstream import (
+    HwpxDocument,
+    hwp5_conversion_report,
+    hwp5_document_bytes,
+    hwpx_view_bytes,
+    is_hwp5_source,
+    is_hwp5_target,
+    native_hwp5_supported,
+    open_document,
+    validate_document_path,
+)
 from .workspace import (
     LEGACY_SANDBOX_ROOT_ENV,
     LEGACY_WORKSPACE_ROOTS_ENV,
@@ -231,8 +242,7 @@ class LocalDocumentStorage:
 
     def open_document(self, path: str) -> Tuple[HwpxDocument, Path]:
         resolved = self.resolve_path(path)
-        require_hwpx_editor_open_safe(resolved, role="local HWPX open")
-        document = open_document(resolved)
+        document = open_local_document(resolved, role="local HWPX open")
         return document, resolved
 
     def save_document(
@@ -241,12 +251,15 @@ class LocalDocumentStorage:
         # General document saves use the SavePipeline gate. Byte-preserving
         # form writers have their own guarded open-safety publication path.
         quality_contract.assert_write_capability()
+        if is_hwp5_target(target):
+            require_native_hwp5()
         guard = self.capture_output_guard(target)
         self.maybe_backup(target)
         pre_save_snapshot = build_hwpx_presave_snapshot(target)
         # Validate in an isolated temp, then publish through the identity-bound
         # workspace guard. Candidate creation never follows the output parent.
-        tmp_fd, tmp_path_str = tempfile.mkstemp(suffix=target.suffix)
+        # The gate always checks HWPX parts, so an .hwp target is staged as HWPX.
+        tmp_fd, tmp_path_str = tempfile.mkstemp(suffix=_staging_suffix(target))
         tmp_path = Path(tmp_path_str)
         try:
             os.close(tmp_fd)
@@ -259,7 +272,8 @@ class LocalDocumentStorage:
                     "saved HWPX failed open-safety verification: "
                     + verification_report["openSafety"]["summary"]
                 )
-            self.atomic_write_bytes(guard, tmp_path.read_bytes())
+            data = _published_bytes(document, target, tmp_path, verification_report)
+            self.atomic_write_bytes(guard, data)
             verification_report["filePath"] = str(target)
             verification_report["visualComplete"] = quality_contract.visual_complete_block(report)
             return verification_report
@@ -304,6 +318,75 @@ def require_hwpx_editor_open_safe(
     return open_safety
 
 
+def require_native_hwp5() -> None:
+    """Refuse ``.hwp`` work clearly when the installed core cannot read or write it."""
+
+    if not native_hwp5_supported():
+        raise HwpDocumentError(
+            "설치된 python-hwpx는 HWP 5.0(.hwp) 문서를 열거나 저장하지 못합니다.",
+            code="READ_ONLY_HWP_DOCUMENT",
+        )
+
+
+def open_local_document(path: Path, *, role: str) -> HwpxDocument:
+    """Open a local HWPX or HWP 5.0 document for editing.
+
+    An HWPX package must pass the editor open-safety check first. An ``.hwp``
+    file is converted by python-hwpx, which refuses damaged, encrypted and
+    DRM files itself (``Hwp5Error``).
+    """
+
+    if is_hwp5_source(path):
+        require_native_hwp5()
+        return open_document(path)
+    require_hwpx_editor_open_safe(path, role=role)
+    return open_document(path)
+
+
+def require_hwpx_package(
+    source: Path | str, *, output: Path | str | None = None
+) -> None:
+    """Refuse an ``.hwp`` source or output for editors that patch HWPX package bytes."""
+
+    if is_hwp5_source(source) or (output is not None and is_hwp5_target(output)):
+        raise HwpDocumentError(
+            "이 도구는 HWPX 패키지의 바이트를 직접 고치므로 HWP 5.0(.hwp) 문서를 입력이나 출력으로 쓸 수 없습니다.",
+            code="HWPX_PACKAGE_REQUIRED",
+        )
+
+
+def _staging_suffix(target: Path) -> str:
+    return ".hwpx" if is_hwp5_target(target) else (target.suffix or ".hwpx")
+
+
+def _published_bytes(
+    document: HwpxDocument,
+    target: Path,
+    staged: Path,
+    verification_report: Dict[str, Any],
+) -> bytes:
+    """The bytes to publish at *target*: the verified HWPX, or HWP 5.0 for ``.hwp``.
+
+    The HWP 5.0 bytes are reopened before anything is written, and the report
+    records what an ``.hwp`` source could not carry into the document model.
+    """
+
+    conversion = hwp5_conversion_report(document)
+    if conversion is not None and (conversion["unconverted"] or conversion["dropped"]):
+        verification_report["hwpConversion"] = conversion
+        verification_report["warnings"].append(
+            "content the .hwp source could not carry into the document model is not in the saved file"
+        )
+    if not is_hwp5_target(target):
+        return staged.read_bytes()
+    data = hwp5_document_bytes(document)
+    reopened = open_document(data)
+    reopened.close()
+    verification_report["format"] = "hwp"
+    verification_report["fileSizeBytes"] = len(data)
+    return data
+
+
 @dataclass(slots=True)
 class _RestDocumentClient:
     """Default HTTP client used by :class:`HttpDocumentStorage`."""
@@ -423,7 +506,10 @@ class HttpDocumentStorage:
         try:
             with os.fdopen(tmp_fd, "wb") as tmp_fh:
                 tmp_fh.write(payload)
-            require_hwpx_editor_open_safe(tmp_path, role="HTTP storage open")
+            if is_hwp5_source(tmp_path):
+                require_native_hwp5()
+            else:
+                require_hwpx_editor_open_safe(tmp_path, role="HTTP storage open")
             os.replace(tmp_path, local_path)
         except Exception:
             tmp_path.unlink(missing_ok=True)
@@ -437,6 +523,8 @@ class HttpDocumentStorage:
         self, document: HwpxDocument, target: Path, *, quality: Any = None
     ) -> Dict[str, Any]:
         quality_contract.assert_write_capability()
+        if is_hwp5_target(target):
+            require_native_hwp5()
         remote_key = str(target)
         cache_path = self._cache.get(remote_key)
         if cache_path is None:
@@ -445,7 +533,7 @@ class HttpDocumentStorage:
 
         pre_save_snapshot = build_hwpx_presave_snapshot(cache_path if cache_path.exists() else None)
         tmp_fd, tmp_path_str = tempfile.mkstemp(
-            suffix=cache_path.suffix or ".hwpx",
+            suffix=_staging_suffix(cache_path),
             dir=str(cache_path.parent),
         )
         tmp_path = Path(tmp_path_str)
@@ -460,7 +548,9 @@ class HttpDocumentStorage:
                     + verification_report["openSafety"]["summary"]
                 )
             verification_report["visualComplete"] = quality_contract.visual_complete_block(report)
-            payload = tmp_path.read_bytes()
+            payload = _published_bytes(document, target, tmp_path, verification_report)
+            if is_hwp5_target(target):
+                tmp_path.write_bytes(payload)
         except quality_contract.QualityGateError:
             tmp_path.unlink(missing_ok=True)
             raise
@@ -491,6 +581,19 @@ def build_hwpx_presave_snapshot(
     return _collect_hwpx_snapshot(source)
 
 
+def _hwpx_view(source: HwpxVerificationSource) -> HwpxVerificationSource:
+    """*source* itself, or for an ``.hwp`` the HWPX package of its document model.
+
+    HWPX verification reads package parts, so an HWP 5.0 file is checked
+    through the model python-hwpx opens it to.
+    """
+
+    if is_hwp5_source(source):
+        require_native_hwp5()
+        return hwpx_view_bytes(source)
+    return source
+
+
 def _issue_messages(report: Any, attr_name: str = "issues") -> List[str]:
     return [str(issue) for issue in getattr(report, attr_name, ())]
 
@@ -520,6 +623,7 @@ def build_hwpx_open_safety_report(
     document_payload: Dict[str, Any]
     reopen_payload: Dict[str, Any]
 
+    source = _hwpx_view(source)
     dependency_error = _open_safety_dependency_error()
     if dependency_error is not None:
         package_payload = {
@@ -606,8 +710,9 @@ def build_hwpx_verification_report(
     *,
     file_path: Path | None = None,
 ) -> Dict[str, Any]:
-    snapshot = _collect_hwpx_snapshot(source)
-    open_safety = build_hwpx_open_safety_report(source)
+    view = _hwpx_view(source)
+    snapshot = _collect_hwpx_snapshot(view)
+    open_safety = build_hwpx_open_safety_report(view)
     displayed_path = file_path or (source if isinstance(source, Path) else None)
     file_size = len(source) if isinstance(source, bytes) else source.stat().st_size
     totals = snapshot["totals"]
@@ -681,6 +786,7 @@ def _collect_hwpx_snapshot(source: HwpxVerificationSource) -> Dict[str, Any]:
         "suspiciousPatterns": 0,
     }
 
+    source = _hwpx_view(source)
     archive_source = BytesIO(source) if isinstance(source, bytes) else source
     with zipfile.ZipFile(archive_source) as archive:
         names = set(archive.namelist())

hwpx_automation/upstream.py

@@ -12,6 +12,7 @@ from copy import deepcopy
 from os import PathLike
 from typing import Any, Iterable, Literal
 from xml.etree import ElementTree as ET
+from zipfile import ZipFile
 
 from .compat import patch_python_hwpx
 
@@ -59,6 +60,59 @@ def open_document(source: str | PathLike[str] | Any) -> HwpxDocument:
     return HwpxDocument.open(source)
 
 
+# HWP 5.0 (.hwp) files are OLE2 compound files; HWPX files are ZIP packages.
+_OLE2_MAGIC = b"\xd0\xcf\x11\xe0\xa1\xb1\x1a\xe1"
+
+
+def native_hwp5_supported() -> bool:
+    """Whether the installed python-hwpx opens and writes ``.hwp`` itself (6.6.0+)."""
+
+    return hasattr(HwpxDocument, "conversion_report")
+
+
+def is_hwp5_source(source: str | PathLike[str] | bytes) -> bool:
+    """Whether *source* holds an HWP 5.0 file, judged by its leading bytes."""
+
+    if isinstance(source, bytes):
+        return source[:8] == _OLE2_MAGIC
+    try:
+        with open(source, "rb") as stream:
+            return stream.read(8) == _OLE2_MAGIC
+    except OSError:
+        return False
+
+
+def is_hwp5_target(path: str | PathLike[str]) -> bool:
+    """Whether saving to *path* writes HWP 5.0; the extension picks the format."""
+
+    return str(path).lower().endswith(".hwp")
+
+
+def hwp5_conversion_report(document: HwpxDocument) -> dict[str, dict[str, int]] | None:
+    """What opening an ``.hwp`` left out of the model; None for an HWPX source."""
+
+    report = getattr(document, "conversion_report", None)
+    if report is None:
+        return None
+    return {"unconverted": dict(report.unconverted), "dropped": dict(report.dropped)}
+
+
+def hwp5_document_bytes(document: HwpxDocument) -> bytes:
+    """Serialize *document* as HWP 5.0; core raises ``Hwp5Error`` before writing anything."""
+
+    return document.to_bytes(format="hwp")
+
+
+def hwpx_view_bytes(source: str | PathLike[str] | bytes) -> bytes:
+    """The HWPX package of the document model an ``.hwp`` source opens to."""
+
+    document = HwpxDocument.open(source)
+    try:
+        return document.to_bytes()
+    finally:
+        document.close()
+
+
 def new_document() -> HwpxDocument:
     return HwpxDocument.new()
 
@@ -71,11 +125,11 @@ def open_package(path: str | PathLike[str]) -> HwpxPackage:
     return HwpxPackage.open(path)
 
 
-def create_text_extractor(path: str | PathLike[str]) -> TextExtractor:
+def create_text_extractor(path: str | PathLike[str] | ZipFile) -> TextExtractor:
     return TextExtractor(path)
 
 
-def create_object_finder(path: str | PathLike[str]) -> ObjectFinder:
+def create_object_finder(path: str | PathLike[str] | ZipFile) -> ObjectFinder:
     return ObjectFinder(path)
 
 

{python_hwpx_automation-7.3.2.dist-info → python_hwpx_automation-7.3.3.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 7.3.2
+Version: 7.3.3
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -74,7 +74,7 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 발행이 승인된 7.3.2 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.2 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
+> 발행이 승인된 7.3.3 후보 (release-approved; 원격 발행 대기): `python-hwpx 6.6.0 → python-hwpx-automation 7.3.3 → hwpx-plugin 2.4.0` (`5e5c23651f92785a`).
 > 공개 트레인: `python-hwpx 6.6.0 → python-hwpx-automation 7.3.1 → hwpx-plugin 2.4.0`.
 > 공개 좌표는 core·automation PyPI와 plugin GitHub
 > Release·marketplace·실제 marketplace 설치 관찰 후에만 승격합니다.
@@ -162,7 +162,7 @@ PDF와 쪽 PNG로 렌더합니다. 별도 환경에서 실행하므로 호출하
 고정 버전을 건드리지 않습니다.
 
 ```bash
-uvx --from "python-hwpx-automation[oracle]==7.3.2" \
+uvx --from "python-hwpx-automation[oracle]==7.3.3" \
   hwpx render-pdf in.hwpx out.pdf --png out/page --json
 ```
 

{python_hwpx_automation-7.3.2.dist-info → python_hwpx_automation-7.3.3.dist-info}/RECORD

@@ -8,7 +8,7 @@ hwpx_automation/capabilities.py,sha256=6arb_5qH-ZvFcKftDW0r4jWeJI24QfameTZRzLQbz
 hwpx_automation/compat.py,sha256=c08KFbs1IzbXAZbVAUOzuoWoR8BXnBad313rL8e-WcM,1582
 hwpx_automation/configuration.py,sha256=kZmkeDPTDgvl1l-QMkdD2vg4rwZsvfk9pMESrpgoMPI,1371
 hwpx_automation/document_state.py,sha256=18ihSR9i062BaVnni24BEBUPyDIBVwPvKGWFMIVDmjw,2979
-hwpx_automation/errors.py,sha256=vDmByHrKBWgMJ7v2WZPvDhXwERehuOAC7AbhyqTxQAM,10810
+hwpx_automation/errors.py,sha256=EJzNnYaJ4cbYZEqp-zCc0nofVSJJGeYjdRcD_cIX0Ro,13277
 hwpx_automation/execution_lock.py,sha256=-KEYeY7iNaGVV6MwKHA7uacmnLkm_BPzSODLLGnBgMY,459
 hwpx_automation/fastmcp_adapter.py,sha256=fLCm1hOay3LiQFf0fGFMSCb3Dq36weuJHvOb7ScYUd8,27858
 hwpx_automation/form_fill.py,sha256=m_e3Awxa2wCPwPNSlTgGH7ytylxV0u8FEqDdAeyyFsw,48717
@@ -16,12 +16,12 @@ hwpx_automation/form_output_models.py,sha256=qRNtqNjsmTynMWRU6p7SWIfcqglWyAxffmO
 hwpx_automation/hwp_converter.py,sha256=6i1dVntfbAl1esGicvIhquJKDldg0PxGaIdfiE2VzK8,7611
 hwpx_automation/hwp_support.py,sha256=EbM5PQiK9QDJDwFhA1dCxh3I7-5wst5pJXgcr4VK3tY,3371
 hwpx_automation/hwpx_ops.py,sha256=39oO_S_dTQHny1qJhJzUjoQTblAKLTQBnIzITlBwyLY,50991
-hwpx_automation/identity.json,sha256=6mqoUGAXtjfWC3AgfgYxo7idLydg9i-U3D5I8U5xQH4,9820
+hwpx_automation/identity.json,sha256=VcotkeMb4PwBX8t8zD5yRSYeRARrcb3quUBILYFi6kQ,9820
 hwpx_automation/identity.py,sha256=g62OiZ_Bvo3wL8NCHFPmAEfwDSJY4AG_cc6aBipU9zI,473
 hwpx_automation/ingest_adapters.py,sha256=7Lm1Pc__tPKdso0rRORLyy1pmUScr8VVmnTnleSYMXo,2726
 hwpx_automation/markdown_plan.py,sha256=n2H_vhRM-el6Y5KLi21tz-4WzK78-wlE8i8hsUVWu2Y,6886
 hwpx_automation/mcp_cli.py,sha256=rgLgj4bhOyYMHCpSGMy-KgryVieH4nFbV1Y4sV98Slo,798
-hwpx_automation/mixed_form.py,sha256=UHDqqM7OrSb7ZBN0V-0VspA_TFcx3v9xQkTxVUsyAXk,108724
+hwpx_automation/mixed_form.py,sha256=EML3LWACXxEp3Z2BJAG9jG7ARik0Zj8UT1zSeVRRs0Y,108853
 hwpx_automation/mutation_models.py,sha256=SEIZYPxlp2FvnFClOsWS08KWBIL7kiMsvX1n6STpJTE,11690
 hwpx_automation/network_policy.py,sha256=ZemScVr_7w1XbAtuBjVVhO3XMiditjyn5FzQjcaER40,7512
 hwpx_automation/preview_output_models.py,sha256=eKreT-GLLxsUnz3I7nqRjAvMOwbBAbHJsACSVPr5ma0,2490
@@ -30,20 +30,20 @@ hwpx_automation/py.typed,sha256=AbpHGcgLb-kRsJGnwFEktk7uzpZOCcBY74-YBdrKVGs,1
 hwpx_automation/quality.py,sha256=D4S1Zx57V2yEzLPADGk9n_PxuNnxgC5Qw0gnu_72AEQ,13052
 hwpx_automation/quality_generation.py,sha256=pakrQ2K0dLC0faCAi7KVr2k09fEBCz8K-M9Qtjr8Mp4,30427
 hwpx_automation/resources.py,sha256=ksAU7yLkp66h7XOizFwVVXnQ7DBdTx7qYJ81-lnJygY,4859
-hwpx_automation/runtime.py,sha256=e8L3IFLbiqKkrIzyHFBRjoI2K9jkgxSuwr_vWJdFa_c,13029
+hwpx_automation/runtime.py,sha256=QRby9BiHIJfAJogsDsApBlXcLS8oSKVwB3fVFKSdYrw,13789
 hwpx_automation/runtime_services.py,sha256=E74uv1RWasAF93hk-g1zIcWZVvgsOB1nL77zmTmFhYM,3567
 hwpx_automation/server.py,sha256=U2IxqrGJ1EBjNnY8QzJah7ZG0MdXEVZcR0NM1FJ7Qhg,12224
-hwpx_automation/storage.py,sha256=LsIZpp5nc3E9MlG3Wwmewr-527vjO8UDA0w7P2Mgkt8,28969
+hwpx_automation/storage.py,sha256=DfHKo8Q7sRtV44SVCV2V5jkexnkpY7oCZgfUXXg5rFQ,32652
 hwpx_automation/tool_bindings.py,sha256=aHl8N8yTtFrmGKRjdKlNMZEed1qVvC27xF9Y-cfY10I,9816
 hwpx_automation/tool_contract.py,sha256=z8W2RIUSAgiNH8F3TTZhSIKz_L2AYThy6I4uULYzR7c,38794
-hwpx_automation/upstream.py,sha256=WAyly1-iky7WFzD2ZrPg1K6kurz2up0U_1oNW8wGDug,25830
+hwpx_automation/upstream.py,sha256=4JPxC0BzhfVDyLNpnnYGwQ5NNXNXy0YSLu23oPLQP3c,27569
 hwpx_automation/visual_qa.py,sha256=ei2WnH0YvXrCQKa0WmnxaWNX_whRQfSLyDoClEHk0Qs,29813
 hwpx_automation/workspace.py,sha256=WogK_yXmGG42kRMhtruLncRJ6WoKqVh3eMfnItEWtLs,67525
 hwpx_automation/core/__init__.py,sha256=OHgM3he4rGageZEFB4iNv2ni7c6mr1xNNVfMGO1bzz4,74
-hwpx_automation/core/content.py,sha256=_S_k3lFDmTrr0F4yOrPo60zpaWMTq0d3mAXMmwe5GVA,31233
+hwpx_automation/core/content.py,sha256=K3iogv6Qsb9xy3wPud6QYSZZRJvPtWKuWvK8rG76qqc,31789
 hwpx_automation/core/context.py,sha256=cG6XC5TpCB-_D8QDnqRsOwpxdstQWfb0gtmYBDzNV50,2966
 hwpx_automation/core/diff.py,sha256=9_YLUyO88Yepvq-Hdr35fakjJ0plc1Krkc0IErMvGMo,1522
-hwpx_automation/core/document.py,sha256=_7jLJOfU4WdVnOk9tqzhk-bnVqE95-PYueUskCsUT5M,1179
+hwpx_automation/core/document.py,sha256=3PradsOWv6akKEsA1cM8XaUwp9NDI5aqIEtD1yxkYuY,1135
 hwpx_automation/core/formatting.py,sha256=FsomTQeTC385wreflLhwzP18kCD-jLfP9j1Xu0fHYVI,15770
 hwpx_automation/core/handles.py,sha256=v7HCAW2cWVu3OarPiDFRSixNncP1FIVRcTIPp5MeWAA,705
 hwpx_automation/core/locations.py,sha256=FVbgLhGka9jaUeU2lG8illML15cxi31ouWP05oQBzI4,7634
@@ -51,17 +51,17 @@ hwpx_automation/core/locator.py,sha256=Q3CfVniPaMSXQ2ABV0JXmTNROkHtKZLz5VR4mCmlJ
 hwpx_automation/core/plan.py,sha256=sNFIko5USDhvs7NA_gy4hSUV40q4vIQTc_dZ2d-nFXE,22744
 hwpx_automation/core/resources.py,sha256=PNPhcGEwq4BrRdMrytgIfeT2_4nrDFB9z97OfxCaQBc,1198
 hwpx_automation/core/search.py,sha256=OmUs0wLPxMrmkhbBiiiQQC-YKG8zjz4bHvJbmCae_eU,12280
-hwpx_automation/core/transactions.py,sha256=wViQxRy0FPlPQKtDZSeFSKxjnK632RtQYN7XI5bRrlU,16452
+hwpx_automation/core/transactions.py,sha256=4Dn13n3fmDl7PHZ3AGRyf09gioNLcC-TgD6-TrqHqzQ,16909
 hwpx_automation/core/txn.py,sha256=gXbv3JFRnYnWY3L57YeTdpFyQaBBMlvLd-dix7NVFog,1449
 hwpx_automation/handlers/__init__.py,sha256=iLzNXNd-ernCvKTi4V8h2XzvFDoM4biZp34KIL0fgsg,83
 hwpx_automation/handlers/_shared.py,sha256=DShvk2vhvtc6Ufy-gVol_S9yP-u_2Gj-iuxArQVne4o,13009
-hwpx_automation/handlers/agent_document.py,sha256=4ZtJOIxFrimYoIAPgVXH8jMUmT4xDzMCBct9wuiAYkA,8195
+hwpx_automation/handlers/agent_document.py,sha256=RBA3A8braZ3B2zMqSavUHZ_Uk_M1Olwm2O4-SwTVS5U,8388
 hwpx_automation/handlers/authoring.py,sha256=7qcFFViTUZQyjhpvNbE6zD8QOsMpDOOMTV8sUKV9MZs,26209
 hwpx_automation/handlers/content_edit.py,sha256=qZH5TcMrSt4zNYCI6Wy_oCiilLLi7d1RYvHQNDjPVKo,42291
 hwpx_automation/handlers/form_fill.py,sha256=oAalDItZwIinHWYIvMUpEIZTPKXpasGSgWoKyQQLYVw,22382
 hwpx_automation/handlers/layout_style.py,sha256=j-vivR4KHbrSAfslx1c2Lba__b8zv-S6-epTjmwbBRs,23705
 hwpx_automation/handlers/quality_render.py,sha256=JK6xedmHYtf8KWrYzI5A2L69pI_Dz0nfQqibz2L5SM8,24763
-hwpx_automation/handlers/read_export.py,sha256=tUelild88uWMrypZeilbM4fod70eF5h-skdAnIPOYCg,44840
+hwpx_automation/handlers/read_export.py,sha256=f8phMXVUlUIsY1WWgXonKCLpnqqXmNpa0kFNfBrayws,45085
 hwpx_automation/handlers/specialized.py,sha256=wvq0P-7MiZCN36Ba4Q1V-9Tl_T7MB3Cn0rC4RGjxt_k,29223
 hwpx_automation/handlers/tracked_changes.py,sha256=bYlVFVsuF6DSvlxOdvv4MavPI2IByudTkYl8_NDoN8U,20598
 hwpx_automation/handlers/workflow.py,sha256=xjkuocWyFKFFdPYX2sQDxtwyGZwn1hqX2SZ6e-TpIBI,2988
@@ -179,7 +179,7 @@ hwpx_automation/office/rendering/detectors.py,sha256=k7t79nWIBSqStNNdwPohmUG2zwr
 hwpx_automation/office/rendering/diff.py,sha256=SJW7HgDyBFbJDL2yHM1cCnCSkGP7CoYuqonABoWh_eo,5743
 hwpx_automation/office/rendering/fixture_corpus.py,sha256=fqx9rRwLCBZ0unhgWCm8V-_xs5597AbBdiDaW5ey5M8,7595
 hwpx_automation/office/rendering/mac_session.py,sha256=DwNpzWwhxIhu_v5PBlLZd6YcPuMlcXREhswKsvIV82k,4021
-hwpx_automation/office/rendering/oracle.py,sha256=jlDyXpeaDAPxzrgdiMpJXWYOyLQCgJ6NubNKx6QstaQ,44211
+hwpx_automation/office/rendering/oracle.py,sha256=dzsRIEmmC7NVzWY0ZhScT0L8jyDlz5HQJXES9U_BKUs,44782
 hwpx_automation/office/rendering/page_qa.py,sha256=BG5kqboMg7SyAi6tAi78LYq1ZmRh30uo72JpPN4Hk2Q,7352
 hwpx_automation/office/rendering/qa_contracts.py,sha256=1cjoiRTAWgi7NgE8SPc6bKxdoUfKx9nyou1mgC47TxY,10506
 hwpx_automation/office/rendering/qa_metrics.py,sha256=ijskhoieoEGk4bwos70XAvA8qDVTOOu4CJUH783cB9w,9859
@@ -190,17 +190,17 @@ hwpx_automation/ops_services/__init__.py,sha256=OUtolsBwPX7kzfmOmanHZK98HFU5ylYw
 hwpx_automation/ops_services/_border_fill.py,sha256=2ruoojd7xLvbC829O95mYnE75RgjbAHcYRZ0HymTMWw,9143
 hwpx_automation/ops_services/composition.py,sha256=xMWDquck6Ii8YQlUZwS3oW5F753FgN64tbSv8O32xWA,1944
 hwpx_automation/ops_services/content_layout.py,sha256=2iq1V2UbTJy299Vl-iTPBvvN8VETAs0fDVUu4SJVKGw,19488
-hwpx_automation/ops_services/context.py,sha256=9-p-uQ9KtG7NlZfK64gCDiU0ZwobeYApBqb3x4EAdUM,8397
-hwpx_automation/ops_services/form_fields.py,sha256=myuKlTyLQC-ievDPjWtdben_PF--qZS6epnBmUrBjEM,31259
+hwpx_automation/ops_services/context.py,sha256=LT7rAio0MgChQ5PDt50sZH_XlrPbpV6QTKoyKS8bXZ4,10240
+hwpx_automation/ops_services/form_fields.py,sha256=uc_1a-M1JClRGVbRfxhxWNDI1lsy29nJVAFZmxbRf20,31448
 hwpx_automation/ops_services/media.py,sha256=ewqIPMZVFxesh9Sr1Uc7HcX6Es2GIdHRhh2J9IQq6LM,7945
 hwpx_automation/ops_services/memo_style.py,sha256=j5y5gRjkrLRNnH7q_u855raKfHUAcCURpqHTe09eFso,16585
-hwpx_automation/ops_services/package_validation.py,sha256=ICMqGuuxUoGRTQL8uGvsdlaGShLip67Oj5JENSrHabo,6321
-hwpx_automation/ops_services/planning.py,sha256=_ZNerdBZ_DERzSsJ5WMJF5Z6xgl6yHjbgJNIuXxSGy8,6625
+hwpx_automation/ops_services/package_validation.py,sha256=vPxHG174N8MIbkEVareO73speR-rYNtve9zSpWVChAI,6349
+hwpx_automation/ops_services/planning.py,sha256=3yN3e-5zdD6pFuIKoB5IvwuVX0hLVGX6hGoppHJfYDI,6653
 hwpx_automation/ops_services/preview_export.py,sha256=1NAQT3j1Ej98MIv4pCDDnYd83w4tTemHmoFWTidRWHw,23504
-hwpx_automation/ops_services/read_query.py,sha256=9qn0GQdfrm_ImlSMrDulNngDcB8wD7caFbLVDxrcPQo,23192
-hwpx_automation/ops_services/save_policy.py,sha256=-YMEfwzR9gsrED5EUPgeGkGDFbQ76m4NXaYEkqEoV1Q,23686
+hwpx_automation/ops_services/read_query.py,sha256=z13Exfvweu_qhTFW0EBR8sn5GaVWhe9HlLuFkuNUaug,23655
+hwpx_automation/ops_services/save_policy.py,sha256=sOh6FDy9E6niI6KnwpzWbIf-hnGrmxGw9oOG15vnsi4,23819
 hwpx_automation/ops_services/tables.py,sha256=psGpwWY8B2Gx611sRri4X7xIQaiZ0DtZvOadj8n1t14,19089
-hwpx_automation/ops_services/transactions.py,sha256=Z4OUQiRKfrt4nUceqqy4nDF8p14dFevbFKsb0Rafhps,26317
+hwpx_automation/ops_services/transactions.py,sha256=iLSrZOj8a2q3tGcCeVQu0-2xH-NqPt5YoQgz37qkNIo,26382
 hwpx_automation/utils/__init__.py,sha256=MIE-UrcJ-Trz80UxicViKiGCXNqe3L5lC1f0acVZwUM,65
 hwpx_automation/utils/helpers.py,sha256=nTuzGdXmhDJFODSs2pQZNNOdvrKeU457rJq4Vo3W5cY,762
 hwpx_automation/utils/read_budget.py,sha256=K71qu5D9fblRXFvSQqe8e7yFOMRK0UuWR5xSpq350Jk,4416
@@ -219,10 +219,10 @@ hwpx_automation/workflow/rendering.py,sha256=MAuL3vSS0vfo-R8ws55E52ddnBrtoYmYikT
 hwpx_automation/workflow/service.py,sha256=dKhcWQVHVBh8752pIDPSvHPXpsQsmB25hrJD7IsgObc,35945
 hwpx_automation/workflow/state_machine.py,sha256=8nFj3WPoqBj0H2j9WRbdAUCT7tm3q_ieQsaEX7LPnE4,2230
 hwpx_automation/workflow/store.py,sha256=S2BTR5g21WgFYfi8ZwvgWQCv7wxUSA8ttlMS9-zNeoU,31663
-python_hwpx_automation-7.3.2.dist-info/licenses/LICENSE,sha256=_ubz4wv-BkkT3l3gu-QuH7JGeVjuRYGZoZK95eNsCHU,9688
-python_hwpx_automation-7.3.2.dist-info/licenses/NOTICE,sha256=B6vl9SzBdZ0LlAeEd89Q3P6r_rlXZWD6ZJK6Ntz3s6A,644
-python_hwpx_automation-7.3.2.dist-info/METADATA,sha256=jJzZjAs4hDke7LtsNYTGPHd1QGRmvQ5WXPAkVW9384k,13819
-python_hwpx_automation-7.3.2.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
-python_hwpx_automation-7.3.2.dist-info/entry_points.txt,sha256=6YDtwFKwyk9BNTR_iCVV0XTwtDRVwENVNvv3wHM81KQ,114
-python_hwpx_automation-7.3.2.dist-info/top_level.txt,sha256=jQZZqF1u9rVIJvragSUf8HCHkm0gFVaCViNDZEKfh1A,16
-python_hwpx_automation-7.3.2.dist-info/RECORD,,
+python_hwpx_automation-7.3.3.dist-info/licenses/LICENSE,sha256=_ubz4wv-BkkT3l3gu-QuH7JGeVjuRYGZoZK95eNsCHU,9688
+python_hwpx_automation-7.3.3.dist-info/licenses/NOTICE,sha256=B6vl9SzBdZ0LlAeEd89Q3P6r_rlXZWD6ZJK6Ntz3s6A,644
+python_hwpx_automation-7.3.3.dist-info/METADATA,sha256=6SO3powknTW6MECFSnJpEXFYHYQTn85iFMVdDcKnabo,13819
+python_hwpx_automation-7.3.3.dist-info/WHEEL,sha256=YVMoNqKzERt-wjUZwJ33xBGAwnFl-4cqbYkTtWa4itE,91
+python_hwpx_automation-7.3.3.dist-info/entry_points.txt,sha256=6YDtwFKwyk9BNTR_iCVV0XTwtDRVwENVNvv3wHM81KQ,114
+python_hwpx_automation-7.3.3.dist-info/top_level.txt,sha256=jQZZqF1u9rVIJvragSUf8HCHkm0gFVaCViNDZEKfh1A,16
+python_hwpx_automation-7.3.3.dist-info/RECORD,,