python-hwpx-automation 6.1.3__tar.gz → 6.2.1__tar.gz

{python_hwpx_automation-6.1.3/src/python_hwpx_automation.egg-info → python_hwpx_automation-6.2.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-hwpx-automation
-Version: 6.1.3
+Version: 6.2.1
 Summary: Task-oriented HWPX document automation for Python, with an optional MCP adapter.
 Author: Kohkyuhyun
 License-Expression: Apache-2.0
@@ -20,7 +20,7 @@ Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
-Requires-Dist: python-hwpx<6,>=5.1.0
+Requires-Dist: python-hwpx<6,>=5.2.0
 Requires-Dist: pydantic<3,>=2.11
 Requires-Dist: cryptography>=42.0
 Requires-Dist: anyio>=4.0
@@ -74,11 +74,12 @@ Dynamic: license-file
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 소스 트리는 아직 공개되지 않은 6.1.3 후보입니다(누름틀 필드 저작
-> `add_form_field`, 계약 `ac1a422376b5ac84`, 128 도구). 현재 공개 트레인은
-> `python-hwpx 5.0.2 → python-hwpx-automation 6.0.4 → hwpx-plugin 1.0.1`
-> (계약 `0ce938371f0b55a6`)입니다. core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격하며, 기존
+> 이 저장소의 main은 아직 공개되지 않은 6.2.1 후보 — release-approved 상태의 후보(수식 저작 `add_equation`,
+> 계약 `342cf672f29cd183`, 129 도구)입니다. 현재 공개 트레인은
+> `python-hwpx 5.1.1 → python-hwpx-automation 6.1.3 → hwpx-plugin 1.1.0`
+> (계약 `ac1a422376b5ac84`, 2026-07-31 released)입니다. 공개 트레인은
+> core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
 > 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
 > 머신: [릴리스 runbook](docs/release-runbook.md)
 
@@ -134,7 +135,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==6.0.4",
+        "python-hwpx-automation[mcp]==6.1.3",
         "hwpx-automation-mcp"
       ],
       "env": {

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/README.md

@@ -14,11 +14,12 @@
 
 <!-- release-state: release-approved -->
 > [!NOTE]
-> 이 소스 트리는 아직 공개되지 않은 6.1.3 후보입니다(누름틀 필드 저작
-> `add_form_field`, 계약 `ac1a422376b5ac84`, 128 도구). 현재 공개 트레인은
-> `python-hwpx 5.0.2 → python-hwpx-automation 6.0.4 → hwpx-plugin 1.0.1`
-> (계약 `0ce938371f0b55a6`)입니다. core·automation PyPI와 plugin GitHub
-> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격하며, 기존
+> 이 저장소의 main은 아직 공개되지 않은 6.2.1 후보 — release-approved 상태의 후보(수식 저작 `add_equation`,
+> 계약 `342cf672f29cd183`, 129 도구)입니다. 현재 공개 트레인은
+> `python-hwpx 5.1.1 → python-hwpx-automation 6.1.3 → hwpx-plugin 1.1.0`
+> (계약 `ac1a422376b5ac84`, 2026-07-31 released)입니다. 공개 트레인은
+> core·automation PyPI와 plugin GitHub
+> Release·marketplace·실제 marketplace 설치까지 확인한 뒤 승격했으며, 기존
 > 5.x 설치는 별도 발행된 `hwpx-mcp-server 5.1.1`이 보호합니다. 절차와 상태
 > 머신: [릴리스 runbook](docs/release-runbook.md)
 
@@ -74,7 +75,7 @@ Gemini CLI는 `~/.gemini/settings.json`, Cursor·Windsurf는 각 에디터의 MC
       "command": "uvx",
       "args": [
         "--from",
-        "python-hwpx-automation[mcp]==6.0.4",
+        "python-hwpx-automation[mcp]==6.1.3",
         "hwpx-automation-mcp"
       ],
       "env": {

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "python-hwpx-automation"
-version = "6.1.3"
+version = "6.2.1"
 description = "Task-oriented HWPX document automation for Python, with an optional MCP adapter."
 readme = "README.md"
 authors = [{ name = "Kohkyuhyun" }]
@@ -29,7 +29,7 @@ dependencies = [
     # the bounded major here is what makes "no valid install has two declarers"
     # true rather than hopeful, and prevents the next core major from silently
     # breaking an already-published automation line.
-    "python-hwpx>=5.1.0,<6", # HWPX object model, OXML/OPC, format-native primitives
+    "python-hwpx>=5.2.0,<6", # HWPX object model, OXML/OPC, format-native primitives
 
     "pydantic>=2.11,<3",
     "cryptography>=42.0",

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/handlers/content_edit.py

@@ -42,6 +42,7 @@ from ._shared import (
     _normalize_fill_mappings,
     _revision_guard,
     _save_doc_verification,
+    _with_document_state,
     _with_dry_run_verification,
     _with_save_verification,
 )
@@ -679,6 +680,41 @@ def add_page_break(
     return _with_save_verification({"success": True}, verification)
 
 
+def add_equation(
+    filename: str,
+    latex: str = None,
+    script: str = None,
+    paragraph_index: int = None,
+    table_index: int = None,
+    row: int = None,
+    col: int = None,
+    base_unit: int = 1100,
+    dry_run: bool = False,
+    expected_revision: str = None,
+) -> dict:
+    """네이티브 수식(<hp:equation>)을 삽입합니다. latex(권장) 또는 EqEdit script 중
+    하나만 지정 — LaTeX는 렌더 검증된 토큰셋만 EqEdit로 변환하고, 밖이면
+    EQUATION_LATEX_UNSUPPORTED로 거부합니다(무음 근사 없음). 산출 수식은 실한컴이
+    조판하고 기존 리더(eqedit_to_latex)가 되읽습니다(응답 readerLatex).
+    배치: 기본=문서 끝 새 문단, paragraph_index=기존 문단, tableIndex+row+col=표 셀."""
+    path = resolve_path(filename)
+    guard = _revision_guard(path, expected_revision)
+    if guard is not None:
+        return guard
+    result = RUNTIME_SERVICES.ops.add_equation(
+        path,
+        latex=latex,
+        script=script,
+        paragraph_index=paragraph_index,
+        table_index=table_index,
+        row=row,
+        col=col,
+        base_unit=base_unit,
+        dry_run=dry_run,
+    )
+    return _with_document_state(result, path)
+
+
 def insert_picture(
     filename: str,
     image_base64: str,
@@ -1060,6 +1096,7 @@ __all__ = [
     "insert_paragraph",
     "delete_paragraph",
     "add_page_break",
+    "add_equation",
     "apply_edits",
     "undo_last_edit",
     "replace_by_anchor",

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/hwpx_ops.py

@@ -517,6 +517,31 @@ class HwpxOps:
             path, text, section_index=section_index, run_style=run_style
         )
 
+    def add_equation(
+        self,
+        path: str,
+        *,
+        latex: Optional[str] = None,
+        script: Optional[str] = None,
+        paragraph_index: Optional[int] = None,
+        table_index: Optional[int] = None,
+        row: Optional[int] = None,
+        col: Optional[int] = None,
+        base_unit: int = 1100,
+        dry_run: bool = False,
+    ) -> Dict[str, Any]:
+        return self._services.content_layout.add_equation(
+            path,
+            latex=latex,
+            script=script,
+            paragraph_index=paragraph_index,
+            table_index=table_index,
+            row=row,
+            col=col,
+            base_unit=base_unit,
+            dry_run=dry_run,
+        )
+
     def insert_paragraphs_bulk(
         self,
         path: str,

python_hwpx_automation-6.2.1/src/hwpx_automation/identity.json

@@ -0,0 +1,263 @@
+{
+ "schemaVersion": "python-hwpx-automation.identity/v1",
+ "product": "python-hwpx-automation",
+ "releaseMajor": 6,
+ "releaseState": {
+  "status": "release-approved",
+  "candidate": {
+   "pythonHwpx": "5.2.0",
+   "canonicalDistribution": "python-hwpx-automation",
+   "canonicalAutomation": "6.2.1",
+   "compatibilityDistribution": "hwpx-mcp-server",
+   "compatibility": "6.2.1",
+   "plugin": "1.2.0",
+   "contractHash": "342cf672f29cd183"
+  },
+  "currentPublic": {
+   "pythonHwpx": "5.1.1",
+   "primaryDistribution": "python-hwpx-automation",
+   "primaryApplication": "6.1.3",
+   "plugin": "1.1.0",
+   "contractHash": "ac1a422376b5ac84"
+  },
+  "promotionGate": "Three states are mandatory: unreleased-candidate while auditing; release-approved only after separate owner approval and while currentPublic still names the previously observed coherent stack; released only in a follow-up commit after remote truth is observed for core, canonical automation, the compatibility distribution, the plugin GitHub release, the marketplace entry, and a real marketplace install. The automation tag workflow publishes only release-approved, leaves currentPublic unchanged, and hands an attached receipt to plugin publication."
+ },
+ "identifiers": [
+  {
+   "surface": "repository",
+   "value": "airmang/python-hwpx-automation",
+   "classification": "canonical"
+  },
+  {
+   "surface": "distribution",
+   "value": "python-hwpx-automation",
+   "classification": "canonical"
+  },
+  {
+   "surface": "import-namespace",
+   "value": "hwpx_automation",
+   "classification": "canonical"
+  },
+  {
+   "surface": "task-console",
+   "value": "hwpx",
+   "classification": "canonical"
+  },
+  {
+   "surface": "mcp-console",
+   "value": "hwpx-automation-mcp",
+   "classification": "canonical"
+  },
+  {
+   "surface": "fastmcp-server-info-name",
+   "value": "python-hwpx-automation",
+   "classification": "canonical"
+  },
+  {
+   "surface": "host-config-key",
+   "value": "hwpx",
+   "classification": "host-local-alias"
+  },
+  {
+   "surface": "environment-prefix",
+   "value": "HWPX_AUTOMATION_",
+   "classification": "canonical"
+  },
+  {
+   "surface": "distribution",
+   "value": "hwpx-mcp-server",
+   "classification": "compatibility"
+  },
+  {
+   "surface": "import-namespace",
+   "value": "hwpx_mcp_server",
+   "classification": "compatibility"
+  },
+  {
+   "surface": "mcp-console",
+   "value": "hwpx-mcp-server",
+   "classification": "compatibility"
+  },
+  {
+   "surface": "environment-prefix",
+   "value": "HWPX_MCP_",
+   "classification": "compatibility"
+  },
+  {
+   "surface": "capability-version-field",
+   "value": "versions.automation",
+   "classification": "canonical"
+  },
+  {
+   "surface": "capability-version-field",
+   "value": "versions.mcp",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "capability-floor-field",
+   "value": "minAutomationVersion",
+   "classification": "canonical"
+  },
+  {
+   "surface": "capability-floor-field",
+   "value": "minMcpVersion",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "contract-floor-constant",
+   "value": "MIN_AUTOMATION_VERSION",
+   "classification": "canonical"
+  },
+  {
+   "surface": "contract-floor-constant",
+   "value": "MIN_MCP_VERSION",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "protocol-error-schema",
+   "value": "hwpx.mcp-error/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.authoring-runtime-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.compliance-quality-utilities-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.document-operations-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.evalplan-runtime-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.exam-runtime-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.form-fill-runtime-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.form-fill-runtime-parity/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-receipt-schema",
+   "value": "hwpx-mcp.visual-runtime-owner/v1",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "frozen-parity-receipt-field",
+   "value": "mcpRuntimeMembers",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "workflow-state-environment",
+   "value": "HWPX_AUTOMATION_WORKFLOW_STORE",
+   "classification": "canonical"
+  },
+  {
+   "surface": "workflow-state-environment",
+   "value": "HWPX_WORKFLOW_STORE",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "workflow-state-path",
+   "value": "${XDG_STATE_HOME:-~/.local/state}/hwpx-mcp-server/workflows.sqlite3",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "render-queue-principal",
+   "value": "hwpx-mcp-server",
+   "classification": "compatibility-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_QUEUE_ROOT",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_QUEUE_URL",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_QUEUE_SECRET",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_TRANSPORT_AUTH",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_CA_FILE",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_CLIENT_CERT_FILE",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "render-integration-environment",
+   "value": "HWPX_RENDER_CLIENT_KEY_FILE",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "workflow-security-environment",
+   "value": "HWPX_WORKFLOW_ENCRYPTION_KEY",
+   "classification": "capability-preserved"
+  },
+  {
+   "surface": "oracle-capability-environment",
+   "value": "HWPX_ORACLE_STRUCTURAL_ONLY",
+   "classification": "capability-preserved"
+  },
+  {
+   "surface": "oracle-capability-environment",
+   "value": "HWPX_ORACLE_BUDGET_SECONDS",
+   "classification": "capability-preserved"
+  },
+  {
+   "surface": "plugin-integration-environment",
+   "value": "HWPX_SKILL_VERSION",
+   "classification": "integration-preserved"
+  },
+  {
+   "surface": "plugin-integration-environment",
+   "value": "HWPX_PLUGIN_ROOT",
+   "classification": "integration-preserved"
+  }
+ ],
+ "compatibilityPolicy": {
+  "supportedThroughMajor": 6,
+  "removalNotBeforeMajor": 7,
+  "minimumPublicNoticeDays": 90,
+  "requiresObservedUsageWindow": true,
+  "requiresSeparateOwnerApproval": true,
+  "statePathMigrationInMajor6": false
+ },
+ "notes": {
+  "hostConfigKey": "The key is a host-local alias, not the MCP protocol identity.",
+  "environmentPrecedence": "HWPX_AUTOMATION_* wins; HWPX_MCP_* remains a 6.x fallback.",
+  "preservedWireIdentifiers": "The public hwpx.mcp-error/v1 schema, versions.mcp/minMcpVersion/MIN_MCP_VERSION aliases, frozen hwpx-mcp.* architecture receipt IDs, and mcpRuntimeMembers parity-receipt field remain exact in 6.x. They are compatibility identifiers, not statements that MCP owns the automation product.",
+  "preservedIntegrationEnvironment": "Product-neutral HWPX_RENDER_*, HWPX_WORKFLOW_ENCRYPTION_KEY, HWPX_ORACLE_*, HWPX_SKILL_VERSION, and HWPX_PLUGIN_ROOT names do not encode the former MCP product identity. They remain unchanged and are not aliases in the HWPX_AUTOMATION_ transition.",
+  "statePath": "HWPX_AUTOMATION_WORKFLOW_STORE wins over the prior HWPX_WORKFLOW_STORE override; the existing hwpx-mcp-server on-disk default remains in 6.x to avoid silent workflow loss.",
+  "renderQueuePrincipal": "The signed queue principal remains hwpx-mcp-server in 6.x so queued work and worker authorization do not split during the rename."
+ }
+}

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/ops_services/content_layout.py

@@ -88,6 +88,134 @@ class ContentLayoutService:
         self._save._save_document(document, resolved)
         return {"paragraphIndex": index}
 
+    def _equation_script_from_input(
+        self, latex: Optional[str], script: Optional[str]
+    ) -> str:
+        from hwpx.equation import (
+            EquationConversionError,
+            UnsupportedLatexError,
+            latex_to_eqedit,
+        )
+
+        if (latex is None) == (script is None):
+            raise self._context._new_error(
+                "EQUATION_INPUT_INVALID",
+                "provide exactly one of latex or script",
+            )
+        if latex is None:
+            assert script is not None
+            return script
+        try:
+            return latex_to_eqedit(latex)
+        except UnsupportedLatexError as exc:
+            raise self._context._new_error(
+                "EQUATION_LATEX_UNSUPPORTED",
+                f"LaTeX outside the render-verified token set: {exc}",
+                details={"latex": latex},
+            ) from exc
+        except EquationConversionError as exc:
+            raise self._context._new_error(
+                "EQUATION_INPUT_INVALID",
+                f"LaTeX input rejected: {exc}",
+            ) from exc
+
+    def _resolve_equation_target(
+        self,
+        document: Any,
+        *,
+        paragraph_index: Optional[int],
+        table_index: Optional[int],
+        row: Optional[int],
+        col: Optional[int],
+    ) -> Any:
+        cell_parts = (table_index, row, col)
+        use_cell = any(part is not None for part in cell_parts)
+        if use_cell and not all(part is not None for part in cell_parts):
+            raise self._context._new_error(
+                "EQUATION_TARGET_INVALID",
+                "provide tableIndex, row, and col together for a cell target",
+            )
+        if use_cell and paragraph_index is not None:
+            raise self._context._new_error(
+                "EQUATION_TARGET_INVALID",
+                "paragraphIndex cannot be combined with a cell target",
+            )
+        if use_cell:
+            assert table_index is not None and row is not None and col is not None
+            tables = self._context._iter_tables(document)
+            try:
+                table = tables[table_index]
+            except IndexError as exc:
+                raise self._context._new_error(
+                    "TABLE_INDEX_OUT_OF_RANGE",
+                    "tableIndex out of range",
+                    details={"tableIndex": table_index},
+                ) from exc
+            try:
+                return table.cell(row, col).paragraphs[-1]
+            except (IndexError, ValueError) as exc:
+                raise self._context._new_error(
+                    "TABLE_CELL_OPERATION_FAILED",
+                    f"failed to resolve table cell for the equation: {exc}",
+                ) from exc
+        if paragraph_index is not None:
+            try:
+                return self._context._iter_paragraphs(document)[paragraph_index]
+            except IndexError as exc:
+                raise self._context._new_error(
+                    "PARAGRAPH_INDEX_OUT_OF_RANGE",
+                    "paragraphIndex out of range",
+                    details={"paragraphIndex": paragraph_index},
+                ) from exc
+        return None
+
+    def add_equation(
+        self,
+        path: str,
+        *,
+        latex: Optional[str] = None,
+        script: Optional[str] = None,
+        paragraph_index: Optional[int] = None,
+        table_index: Optional[int] = None,
+        row: Optional[int] = None,
+        col: Optional[int] = None,
+        base_unit: int = 1100,
+        dry_run: bool = False,
+    ) -> Dict[str, Any]:
+        from hwpx.equation import EquationConversionError, eqedit_to_latex
+
+        script = self._equation_script_from_input(latex, script)
+        document, resolved = self._context._open_document(path)
+        paragraph = self._resolve_equation_target(
+            document,
+            paragraph_index=paragraph_index,
+            table_index=table_index,
+            row=row,
+            col=col,
+        )
+        try:
+            document.add_equation(script, paragraph=paragraph, base_unit=base_unit)
+        except ValueError as exc:
+            raise self._context._new_error(
+                "EQUATION_INPUT_INVALID", str(exc)
+            ) from exc
+        try:
+            reader_latex = eqedit_to_latex(script)
+        except EquationConversionError:
+            reader_latex = None
+        result = {
+            "ok": True,
+            "filename": path,
+            "equation": {
+                "script": script,
+                "readerLatex": reader_latex,
+                "baseUnit": base_unit,
+            },
+        }
+        return self._transactions._with_transaction_verification(
+            result, document, resolved, dry_run=dry_run
+        )
+
     def insert_paragraphs_bulk(
         self,
         path: str,

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/server.py

@@ -81,6 +81,7 @@ list_templates = TOOL_BINDINGS["list_templates"]
 describe_template = TOOL_BINDINGS["describe_template"]
 add_heading = TOOL_BINDINGS["add_heading"]
 add_paragraph = TOOL_BINDINGS["add_paragraph"]
+add_equation = TOOL_BINDINGS["add_equation"]
 insert_paragraph = TOOL_BINDINGS["insert_paragraph"]
 delete_paragraph = TOOL_BINDINGS["delete_paragraph"]
 add_page_break = TOOL_BINDINGS["add_page_break"]

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/tool_bindings.py

@@ -64,6 +64,7 @@ def _build_tool_bindings() -> Mapping[str, Callable[..., Any]]:
         "describe_template": authoring.describe_template,
         "add_heading": content_edit.add_heading,
         "add_paragraph": content_edit.add_paragraph,
+        "add_equation": content_edit.add_equation,
         "insert_paragraph": content_edit.insert_paragraph,
         "delete_paragraph": content_edit.delete_paragraph,
         "add_page_break": content_edit.add_page_break,

{python_hwpx_automation-6.1.3 → python_hwpx_automation-6.2.1}/src/hwpx_automation/tool_contract.py

@@ -20,20 +20,20 @@ from dataclasses import dataclass
 from enum import Enum
 from typing import Any, Callable, Mapping
 
-MIN_PYTHON_HWPX = "5.1.0"
+MIN_PYTHON_HWPX = "5.2.0"
 # The 5.0 train: core drops the workflow surfaces and the `hwpx` console name,
 # this package picks the name up, and the plugin pins both. The three move
 # together — a mixed set is what "no valid install has two declarers" rules out.
-MIN_AUTOMATION_VERSION = "6.1.0"
+MIN_AUTOMATION_VERSION = "6.2.0"
 # Compatibility alias retained in the 6.x contract payload for existing health
 # and plugin consumers. New code and documentation use the automation name.
 MIN_MCP_VERSION = MIN_AUTOMATION_VERSION
-MIN_SKILL_VERSION = "1.1.0"
+MIN_SKILL_VERSION = "1.2.0"
 # Frozen release receipt for non-runtime services. Runtime construction still
 # recomputes and verifies the bound callable/schema contract through
 # ``contract_hash()``; this constant prevents those services from importing the
 # runtime composer merely to stamp the approved release receipt.
-RELEASED_CONTRACT_HASH = "ac1a422376b5ac84"
+RELEASED_CONTRACT_HASH = "342cf672f29cd183"
 
 
 def describe_callables(entries: Any) -> Any:
@@ -309,7 +309,7 @@ _MUTATING_TOOLS = {
     "create_government_report_document", "create_proposal_document",
     "create_comparison_table_document", "register_template",
     "add_heading", "add_paragraph", "insert_paragraph", "delete_paragraph",
-    "add_page_break", "apply_edits", "undo_last_edit",
+    "add_page_break", "add_equation", "apply_edits", "undo_last_edit",
     "replace_by_anchor", "replace_in_paragraph", "search_and_replace", "batch_replace",
     "byte_preserving_patch", "insert_picture", "replace_picture",
     "add_table", "set_table_cell_text", "merge_table_cells", "split_table_cell",
@@ -424,7 +424,7 @@ BASELINE_DOMAIN_SPECS: tuple[DomainSpec, ...] = (
             "add_heading", "add_paragraph", "insert_paragraph", "delete_paragraph", "add_page_break",
             "apply_edits", "undo_last_edit",
             "replace_by_anchor", "replace_in_paragraph", "search_and_replace", "batch_replace",
-            "byte_preserving_patch", "insert_picture", "replace_picture",
+            "byte_preserving_patch", "insert_picture", "replace_picture", "add_equation",
         ),
     ),
     DomainSpec(
@@ -589,18 +589,18 @@ TOOL_SPECS = tuple(spec for spec in BASELINE_TOOL_SPECS if spec.installed)
 def _validate_classification() -> None:
     counts = classification_counts()
     expected = {
-        ToolClassification.PUBLIC.value: 111,
+        ToolClassification.PUBLIC.value: 112,
         ToolClassification.COMPATIBILITY.value: 6,
         ToolClassification.ADVANCED.value: 8,
         ToolClassification.DEPRECATED.value: 3,
         ToolClassification.INTERNAL.value: 4,
     }
-    if len(BASELINE_TOOL_SPECS) != 132 or counts != expected:
+    if len(BASELINE_TOOL_SPECS) != 133 or counts != expected:
         raise RuntimeError(
-            f"132-tool classification must be disjoint and exhaustive: {counts!r} != {expected!r}"
+            f"133-tool classification must be disjoint and exhaustive: {counts!r} != {expected!r}"
         )
-    if len(TOOL_SPECS) != 128:
-        raise RuntimeError(f"installed advanced surface must contain 128 tools, got {len(TOOL_SPECS)}")
+    if len(TOOL_SPECS) != 129:
+        raise RuntimeError(f"installed advanced surface must contain 129 tools, got {len(TOOL_SPECS)}")
     if sum(spec.skill_required for spec in TOOL_SPECS) != 28:
         raise RuntimeError(
             "installed surface must contain exactly 28 skill-required tools"