athena-python-docx 0.1.0__tar.gz → 0.1.2__tar.gz

{athena_python_docx-0.1.0 → athena_python_docx-0.1.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: athena-python-docx
-Version: 0.1.0
+Version: 0.1.2
 Summary: Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack
 Project-URL: Homepage, https://athenaintelligence.ai
 Author-email: Athena Intelligence <engineering@athenaintelligence.ai>

{athena_python_docx-0.1.0 → athena_python_docx-0.1.2}/docx/__init__.py

@@ -6,7 +6,7 @@ See CLAUDE.md for the API parity contract.
 
 from __future__ import annotations
 
-__version__ = "0.1.0"
+__version__ = "0.1.2"
 
 from docx.api import Document
 

{athena_python_docx-0.1.0 → athena_python_docx-0.1.2}/docx/document.py

@@ -100,22 +100,49 @@ class Document:
         from docx.text.paragraph import Paragraph
 
         self._ensure_open()
-        md: str
-        if style and style.lower().startswith("heading"):
-            try:
-                level: int = int(style.rsplit(" ", 1)[-1])
-            except ValueError:
-                level = 1
-            md = f"{'#' * level} {text}\n\n"
+
+        # Superdoc's markdown parser rejects empty input with
+        # "Markdown produced no content to insert." For an empty paragraph
+        # (python-docx's `doc.add_paragraph()` with no args), we use the
+        # text-type insert with a single space and immediately clear it —
+        # same pattern as `agora/web/api/super_docs/superdoc_write_utils.py`
+        # around line 1085.
+        result: dict
+        node_id: str
+        if not text and not (style and style.lower().startswith("heading")):
+            result = run_sync(
+                self._session.doc.insert(
+                    {"value": " ", "type": "text"},
+                ),
+            )
+            node_id = _extract_inserted_node_id(result, expected_type="paragraph")
+            if node_id:
+                # Clear the placeholder space so the paragraph reads as empty
+                # (matches python-docx semantics: a freshly-added blank paragraph
+                # has empty `.text`).
+                run_sync(
+                    self._session.doc.blocks.update_text(
+                        {"nodeId": node_id, "text": ""},
+                    ),
+                )
         else:
-            md = f"{text}\n\n"
+            md: str
+            if style and style.lower().startswith("heading"):
+                try:
+                    level: int = int(style.rsplit(" ", 1)[-1])
+                except ValueError:
+                    level = 1
+                md = f"{'#' * level} {text}\n\n"
+            else:
+                md = f"{text}\n\n"
+
+            result = run_sync(
+                self._session.doc.insert(
+                    {"value": md, "type": "markdown"},
+                ),
+            )
+            node_id = _extract_inserted_node_id(result, expected_type="paragraph")
 
-        result: dict = run_sync(
-            self._session.doc.insert(
-                {"value": md, "type": "markdown"},
-            ),
-        )
-        node_id: str = _extract_inserted_node_id(result, expected_type="paragraph")
         if not node_id:
             raise RuntimeError(
                 f"Superdoc did not return a nodeId for add_paragraph: {result!r}",
@@ -306,12 +333,50 @@ class Document:
 # ---- Module-level helpers ----
 
 def _extract_inserted_node_id(result: dict, *, expected_type: str) -> str:
-    """Parse Superdoc's insert() response to find the new nodeId.
-
-    Superdoc rotates response shape across versions. Defensively probe.
+    """Parse Superdoc's insert() response to find the relevant blockId.
+
+    Superdoc rotates response shapes across versions; we probe in order
+    of "most current" first. Real observed shape (superdoc-sdk 1.6.0.dev29):
+
+        {
+          "receipt": {
+            "resolution": {
+              "target": {"kind": "text", "blockId": "<uuid>", "range": {...}}
+            }
+          },
+          ...
+        }
+
+    Older/alternate shapes we also accept:
+      - top-level ``blockId``
+      - nested ``result.insertedNodes[].nodeId`` (when typed = expected_type)
+      - last element of ``result.nodes``
     """
     if not isinstance(result, dict):
         return ""
+
+    # Shape 1 (current): receipt.resolution.target.blockId
+    receipt: object = result.get("receipt")
+    if isinstance(receipt, dict):
+        resolution: object = receipt.get("resolution")
+        if isinstance(resolution, dict):
+            target: object = resolution.get("target")
+            if isinstance(target, dict):
+                block_id: str = str(target.get("blockId", ""))
+                if block_id:
+                    return block_id
+
+    # Shape 2: top-level blockId or target.blockId
+    top_block: object = result.get("blockId")
+    if isinstance(top_block, str) and top_block:
+        return top_block
+    top_target: object = result.get("target")
+    if isinstance(top_target, dict):
+        tb: str = str(top_target.get("blockId", ""))
+        if tb:
+            return tb
+
+    # Shape 3 (legacy): nested result.result.insertedNodes[] / nodes[]
     data_obj: object = result.get("result", {})
     data: dict = data_obj if isinstance(data_obj, dict) else {}
     nodes_obj: object = data.get("insertedNodes", data.get("nodes", []))
@@ -323,6 +388,7 @@ def _extract_inserted_node_id(result: dict, *, expected_type: str) -> str:
             return str(node.get("nodeId", ""))
     if nodes and isinstance(nodes[-1], dict):
         return str(nodes[-1].get("nodeId", ""))
+
     return ""
 
 

{athena_python_docx-0.1.0 → athena_python_docx-0.1.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "athena-python-docx"
-version = "0.1.0"
+version = "0.1.2"
 description = "Drop-in replacement for python-docx that connects to Athena's Superdoc/Keryx collaborative document stack"
 readme = "README.md"
 license = "MIT"